CcSetDirtyPinnedData function (ntifs.h)

The CcSetDirtyPinnedData routine marks as dirty the buffer control block (BCB) for a pinned buffer whose contents have been modified.

Syntax

void CcSetDirtyPinnedData(
  [in]           PVOID          BcbVoid,
  [in, optional] PLARGE_INTEGER Lsn
);

Parameters

[in] BcbVoid

Pointer to the BCB structure to be marked as dirty.

[in, optional] Lsn

Logical sequence number (LSN) to be associated with this buffer.

Return value

None

Remarks

CcSetDirtyPinnedData marks the BCB as dirty, so that the contents of the pinned buffer will be lazy-written to disk. Even if the flush operation is to be performed by some means other than the lazy writer, CcSetDirtyPinnedData should be called whenever the contents of a pinned buffer are modified. This is especially important if the buffer was pinned only for read access (by CcPinRead or CcPinMappedData). Although buffers that are pinned only for read access can be modified, their contents are not automatically flushed to disk unless the buffers have been marked as dirty by calling CcSetDirtyPinnedData.

Requirements

Requirement Value
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

See also

CcMapData

CcPinMappedData

CcPinRead

CcPreparePinWrite

CcUnpinData