Funzione EtwUnregister (wdm.h)
La funzione EtwUnregister annulla la registrazione del provider di eventi e deve essere chiamata prima dell'uscita dal provider.
Sintassi
NTSTATUS EtwUnregister(
[in] REGHANDLE RegHandle
);
Parametri
[in] RegHandle
Puntatore all'handle di registrazione del provider, restituito dalla funzione EtwRegister se la registrazione del provider di eventi ha esito positivo.
Valore restituito
La funzione EtwUnregister restituisce un codice di stato di STATUS_SUCCESS se il provider di eventi è stato annullato correttamente con ETW.
Commenti
Al termine della traccia, un driver deve chiamare la funzione EtwUnregister per annullare la registrazione del provider. Per ogni chiamata a EtwRegister deve essere presente una chiamata corrispondente a EtwUnregister. L'impossibilità di annullare la registrazione del provider di eventi può causare errori quando il processo viene scaricato perché i callback associati al processo non sono più validi. Non è necessario effettuare chiamate di traccia che non rientrano nel codice delimitato dalle funzioni EtwRegister e EtwUnregister . Per ottenere prestazioni ottimali, è possibile chiamare la funzione EtwRegister nella routine DriverEntry e la funzione EtwUnregister nella routine DriverUnload .
I chiamanti di EtwRegister devono essere in esecuzione in IRQL = PASSIVE_LEVEL nel contesto di un thread di sistema.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe; Ntdll.dll |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |