PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK Rückruffunktion (ntifs.h)

Artikel
02/29/2024

Ein Filtertreiber kann eine PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK typisierte Routine als CleanupCallback-Rückrufroutine des Filtertreibers für eine zusätzliche ECP-Kontextstruktur (Create Parameter) 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 Create-Parametertyp angibt. Weitere Informationen finden Sie unter Verwenden von GUIDs in Treibern.

Rückgabewert

Keine

Bemerkungen

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

Um eine Rückrufroutine anzugeben, übergibt ein Filtertreiber einen Zeiger auf die Rückrufroutine, indem er den CleanupCallback-Parameter der Routine verwendet, die ursprünglich die ECP-Kontextstruktur zugeordnet hat. Wenn keine Rückrufroutine erforderlich ist, muss ein NULL-Wert an den CleanupCallback-Parameter übergeben werden.

Die folgenden Routinen unterstützen die PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK typisierte Rückrufroutine:

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Desktop
Kopfzeile	ntifs.h (include Ntifs.h, FltKernel.h)
IRQL	PASSIVE_LEVEL