Функция EtwUnregister (wdm.h)
Функция EtwUnregister отменяет регистрацию поставщика событий и должна быть вызвана до выхода поставщика.
Синтаксис
NTSTATUS EtwUnregister(
[in] REGHANDLE RegHandle
);
Параметры
[in] RegHandle
Указатель на дескриптор регистрации поставщика, который возвращается функцией EtwRegister в случае успешной регистрации поставщика событий.
Возвращаемое значение
Функция EtwUnregister возвращает код состояния STATUS_SUCCESS, если поставщик событий был успешно отменен с помощью трассировки событий Windows.
Комментарии
После завершения трассировки драйвер должен вызвать функцию EtwUnregister , чтобы отменить регистрацию поставщика. Для каждого вызова EtwRegister должен быть соответствующий вызов EtwUnregister. Сбой при отмене регистрации поставщика событий может привести к ошибкам при выгрузке процесса, так как обратные вызовы, связанные с процессом, больше не являются допустимыми. Не следует выполнять вызовы трассировки, которые выходят за пределы кода, ограниченного функциями EtwRegister и EtwUnregister . Для достижения наилучшей производительности можно вызвать функцию EtwRegister в подпрограмме DriverEntry и функцию EtwUnregister в подпрограмме DriverUnload .
Вызывающие функции EtwRegister должны выполняться в IRQL = PASSIVE_LEVEL в контексте системного потока.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe; Ntdll.dll |
| IRQL | PASSIVE_LEVEL |
| Правила соответствия DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |