PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK funzione di callback (ntifs.h)

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:

• FltAllocateExtraCreateParameter
• FltAllocateExtraCreateParameterFromLookasideList
• FsRtlAllocateExtraCreateParameter

Requisiti

Vedi anche

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltRemoveExtraCreateParameter