CcSetDirtyPinnedData function (ntifs.h)

Article
02/22/2024

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