CachedWrite (Windows Embedded CE 6.0)

1/6/2010

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.

Requirements

See Also

Reference

Disk Cache Manager Functions