CcSetDirtyPinnedData-Funktion (ntifs.h)

Artikel
03/01/2024

Die CcSetDirtyPinnedData-Routine markiert als modifiziert Puffersteuerungsblock (BCB) für einen angehefteten Puffer, dessen Inhalt geändert wurde.

Syntax

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

Parameter

[in] BcbVoid

Zeiger auf die BCB-Struktur, die als modifiziert gekennzeichnet werden soll.

[in, optional] Lsn

Logische Sequenznummer (Logical Sequence Number, LSN), die diesem Puffer zugeordnet werden soll.

Rückgabewert

Keine

Bemerkungen

CcSetDirtyPinnedData markiert den BCB als modifiziert, sodass der Inhalt des angehefteten Puffers faul auf den Datenträger geschrieben wird. Auch wenn der Löschvorgang mit anderen Mitteln als dem lazy Writer ausgeführt werden soll, sollte CcSetDirtyPinnedData immer aufgerufen werden, wenn der Inhalt eines angehefteten Puffers geändert wird. Dies ist besonders wichtig, wenn der Puffer nur für den Lesezugriff angeheftet wurde (durch CcPinRead oder CcPinMappedData). Obwohl Puffer, die nur für den Lesezugriff angeheftet sind, geändert werden können, werden ihre Inhalte nicht automatisch auf den Datenträger geleert, es sei denn, die Puffer wurden durch Aufrufen von CcSetDirtyPinnedData als modifiziert markiert.