Share via


CachedWrite (Compact 2013)

3/26/2014

For a write-through cache, this function writes data to disk and to the cache.

For a write-back cache, this function writes data only to the cache and allows the lazy-writer thread to commit the data to the disk.

Syntax

DWORD CachedWrite(
  DWORD dwCacheId, 
  DWORD dwBlockNum,
  DWORD dwNumBlocks,
  PVOID pBuffer,
  DWORD dwWriteFlags
); 

Parameters

  • dwCacheId
    [in] Cache ID value returned by the CreateCache function.
  • dwBlockNum
    [in] Starting block to write to.
  • dwNumBlocks
    [in] Number of blocks to write.
  • pBuffer
    [in] Pointer to the buffer containing data to write.
  • dwWriteFlags
    [in] This value can be set to CACHE_FORCE_WRITETHROUGH to force the written blocks to be committed to the disk. This only applies for a write-back cache.

Remarks

If the cache location that the data is to be written to overwrites a dirty block that is different from the block to be written, that dirty block is committed to the disk.

Return Value

ERROR_SUCCESS indicates success. A Microsoft Win32 error code indicates failure.

Link Library: Fsdmgr.lib.

Requirements

Header

fsdmgr.h

Library

Fsdmgr.lib

See Also

Reference

Disk Cache Manager Functions