PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK Rückruffunktion (ntifs.h)

2024-12-21

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:

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	ntifs.h (einschließlich Ntifs.h, FltKernel.h)
IRQL-	PASSIVE_LEVEL