PFN_CSP_CACHE_ADD_FILE function pointer

The PFN_CSP_CACHE_ADD_FILE function is called through a pointer in the CARD_DATA structure when the card minidriver wants to add a file to the set of data that resides in the cache of the Base CSP/KSP. Generally, this would be a cache of a file that exists on the card.

Syntax

typedef DWORD ( WINAPI *PFN_CSP_CACHE_ADD_FILE)(
  _In_ PVOID  pvCacheContext,
  _In_ LPWSTR wsaTag,
  _In_ DWORD  dwFlags,
  _In_ PBYTE  pbData,
  _In_ DWORD  cbData
);

Parameters

• pvCacheContext [in]
  The cache context value that is supplied by the Base CSP/KSP and taken from the CARD_DATA structure.

• wsaTag [in]
  The name of the file to add.

• dwFlags [in]
  Reserved. Set to zero.

• pbData [in]
  Pointer to the buffer that contains the data. The buffer is allocated and freed by the card minidriver.

• cbData [in]
  Byte count of the data to which pbData points.

Return value

Zero on success; otherwise, nonzero.

Remarks

Files on the card that the card minidriver uses only internally can take advantage of the Base CSP/KSP-provided caching implementation to improve performance by avoiding redundant read/write activity to the card.

This function is used to initially create or to update the contents of the associated file cache.

Requirements

Send comments about this topic to Microsoft