FltRetainSwappedBufferMdlAddress-Funktion (fltkernel.h)

Artikel
02/27/2024

FltRetainSwappedBufferMdlAddress verhindert, dass der Filter-Manager die Speicherdeskriptorliste (Memory Descriptor List, MDL) für einen Puffer freigibt, der durch einen Minifiltertreiber ausgetauscht wurde.

Syntax

void FltRetainSwappedBufferMdlAddress(
  [in] PFLT_CALLBACK_DATA CallbackData
);

Parameter

[in] CallbackData

Zeiger auf die Rückrufdatenstruktur für den Vorgang.

Rückgabewert

Keine

Bemerkungen

Wenn ein Minifiltertreiber in einem neuen Puffer in einer PFLT_PRE_OPERATION_CALLBACK-Routine (Preoperation Callback) ausgetauscht wird, gibt der Filter-Manager die MDL des Puffers automatisch frei, wenn die entsprechende Rückrufroutine nach der PFLT_POST_OPERATION_CALLBACK (Postoperation) zurückgibt.

Der Minifiltertreiber kann verhindern, dass der Filter-Manager die MDL freigibt, indem Er FltRetainSwappedBufferMdlAddress aus der Rückrufroutine nach der Operation aufruft.

Nach dem Aufruf von FltRetainSwappedBufferMdlAddress ist der Anrufer für die Freigabe der MDL durch Aufrufen einer Routine wie IoFreeMdl verantwortlich.

FltRetainSwappedBufferMdlAddress kann nur aus einer Postoperation-Rückrufroutine aufgerufen werden.