PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK funzione di callback (ntifs.h)

Articolo
02/26/2024

Un driver di filtro può registrare una routine tipizzata PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK come routine di callback CleanupCallback del driver di filtro per una struttura di contesto ECP (Create Parameter) aggiuntiva.

Sintassi

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

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

Parametri

[in, out] EcpContext

Puntatore di contesto ECP restituito dalla routine che ha allocato la struttura del contesto ECP.

[in[] EcpType

Puntatore a un GUID passato alla routine che ha allocato la struttura del contesto ECP, che indica il tipo di parametro di creazione aggiuntivo. Per altre informazioni, vedere Uso dei GUID nei driver.

Valore restituito

nessuno

Osservazioni

Quando un driver di filtro alloca una struttura di contesto ECP, può facoltativamente specificare una routine tipizzata PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK come routine di callback CleanupCallback del driver di filtro. Se il driver di filtro specifica una routine di callback CleanupCallback , il sistema operativo richiamerà la routine CleanupCallback (indipendentemente dal livello IRQ). Questa routine CleanupCallback esegue qualsiasi elaborazione di pulizia correlata al contesto ECP necessaria quando viene eliminata la struttura del contesto ECP.

Per specificare una routine di callback, un driver di filtro passa un puntatore alla routine di callback usando il parametro CleanupCallback della routine che ha originariamente allocato la struttura del contesto ECP. Se non è necessaria una routine di callback, è necessario passare un valore NULL al parametro CleanupCallback .

Le routine seguenti supportano la routine di callback tipizzata PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK:

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Piattaforma di destinazione	Desktop
Intestazione	ntifs.h (include Ntifs.h, FltKernel.h)
IRQL	PASSIVE_LEVEL