Funzione PcwUnregister (wdm.h)

La PcwUnregister funzione chiude la registrazione del contatore specificata. La maggior parte degli sviluppatori userà una funzione UnregisterXxx generata da CTRPP anziché chiamare direttamente questa funzione.

Sintassi

void PcwUnregister(
  PPCW_REGISTRATION Registration
);

Parametri

Registration

[in Un puntatore alla registrazione chiusa.

Valore restituito

nessuno

Osservazioni

La PcwUnregister funzione chiude la registrazione del contatore specificata. Le istanze di proprietà della registrazione contatore vengono chiuse automaticamente. Queste istanze non devono essere accessibili dal provider mentre il contatore viene annullato o dopo che il contatore non viene registrato.

Prima che il provider usi questa funzione, il provider deve chiamare la funzione PcwRegister per creare una registrazione.

Funzione UnregisterXxx generata da CTRPP

La maggior parte degli sviluppatori non deve chiamare PcwUnregister direttamente. Verrà invece compilato un manifesto con lo strumento CTRPP e verrà usata la funzione UnregisterXxx dall'intestazione generata da CTRPP. La funzione generata avrà un aspetto simile al seguente:

EXTERN_C FORCEINLINE VOID
UnregisterMyCounterset(
    VOID
    )
{
    PAGED_CODE();

    PcwUnregister(MyCounterset);
}

La funzione Unregister generata da CTRPP sarà denominata PrefixUnregisterCounterSet. Il prefisso è in genere vuoto, ma può essere presente se il -prefix parametro è stato usato nella riga di comando CTRPP. CounterSet è il nome del contatore, come specificato nel manifesto. Si noti che la funzione fa riferimento a una variabile Counterset (MyCounterset nell'esempio), che è una variabile globale che contiene l'handle di registrazione del contatore inizializzato dalla funzione RegisterXxx generata da CTRPP.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 7 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= APC_LEVEL

Vedi anche

Funzione PcwRegister