PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK Rückruffunktion (ntifs.h)

Ein Filtertreiber kann eine PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK typierte Routine als CleanupCallback- Rückrufroutine des Filtertreibers für eine zusätzliche Create-Parameter-Kontextstruktur (ECP) registrieren.

Syntax

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

void PfsrtlExtraCreateParameterCleanupCallback(
  [in, out] PVOID EcpContext,
  [in[]     LPCGUID EcpType
)
{...}

Parameter

[in, out] EcpContext

Ein ECP-Kontextzeiger, der von der Routine zurückgegeben wurde, die die ECP-Kontextstruktur zugeordnet hat.

[in[] EcpType

Ein Zeiger auf eine GUID, die an die Routine übergeben wurde, die die ECP-Kontextstruktur zugeordnet hat, die den zusätzlichen Erstellungsparametertyp angibt. Weitere Informationen finden Sie unter Verwenden von GUIDs in Drivers.

Rückgabewert

Nichts

Bemerkungen

Wenn ein Filtertreiber eine ECP-Kontextstruktur zuweist, kann optional eine PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK typisierte Routine als CleanupCallback Rückrufroutine des Filtertreibers angegeben werden. Wenn der Filtertreiber eine CleanupCallback- Rückrufroutine angibt, ruft das Betriebssystem die CleanupCallback Routine (unabhängig von IRQ-Ebene) auf. Diese CleanupCallback Routine führt alle erforderlichen ECP kontextbezogenen Bereinigungsverarbeitungen durch, wenn die ECP-Kontextstruktur gelöscht wird.

Um eine Rückrufroutine anzugeben, übergibt ein Filtertreiber mithilfe des CleanupCallback- Parameters der Routine, die ursprünglich die ECP-Kontextstruktur zugeordnet hat, einen Zeiger an die Rückrufroutine. Wenn keine Rückrufroutine erforderlich ist, muss ein NULL- Wert an den parameter CleanupCallback übergeben werden.

Die folgenden Routinen unterstützen die PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK-typierte Rückrufroutine:

• FltAllocateExtraCreateParameter
• FltAllocateExtraCreateParameterFromLookasideList
• FsRtlAllocateExtraCreateParameter

Anforderungen

Siehe auch

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltRemoveExtraCreateParameter