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 |