PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK funzione di callback (ntifs.h)

Articolo
12/21/2024

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

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 di PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK come routine di callback del driver di filtro CleanupCallback routine di callback. Se il driver del filtro specifica un CleanupCallback routine di callback, il sistema operativo richiamerà la routine CleanupCallback (indipendentemente dal livello IRQ). Questa CleanupCallback routine 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 utilizzando il parametro CleanupCallback della routine che originariamente ha 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: