Função EtwUnregister (wdm.h)
A função EtwUnregister cancela o registro do provedor de eventos e deve ser chamada antes da saída do provedor.
Sintaxe
NTSTATUS EtwUnregister(
[in] REGHANDLE RegHandle
);
Parâmetros
[in] RegHandle
Um ponteiro para o identificador de registro do provedor, que é retornado pela função EtwRegister se o registro do provedor de eventos for bem-sucedido.
Valor de retorno
A função EtwUnregister retornará um código de status de STATUS_SUCCESS se o provedor de eventos não tiver sido registrado com êxito com ETW.
Observações
Após a conclusão do rastreamento, um driver deve chamar a função EtwUnregister para cancelar o registro do provedor. Para cada chamada para EtwRegister deve haver uma chamada correspondente para etwUnregister. Falha ao cancelar o registro do provedor de eventos pode causar erros quando o processo é descarregado porque os retornos de chamada associados ao processo não são mais válidos. Nenhuma chamada de rastreamento deve ser feita que esteja fora do código delimitado pelas funções EtwRegister e EtwUnregister. Para obter o melhor desempenho, você pode chamar a função EtwRegister em sua rotina de DriverEntry e a função EtwUnregister em sua rotina de driverunload.
Os chamadores de etwRegister devem estar em execução em IRQL = PASSIVE_LEVEL no contexto de um thread do sistema.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe; Ntdll.dll |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |