EtwUnregister 関数 (wdm.h)

EtwUnregister 関数はイベント プロバイダーの登録を解除し、プロバイダーが終了する前に呼び出す必要があります。

構文

NTSTATUS EtwUnregister(
  [in] REGHANDLE RegHandle
);

パラメーター

[in] RegHandle

イベント プロバイダーの登録が成功した場合に EtwRegister 関数によって返されるプロバイダー登録ハンドルへのポインター。

戻り値

EtwUnregister 関数は、イベント プロバイダーが ETW で正常に登録解除された場合にSTATUS_SUCCESSの状態コードを返します。

注釈

トレースが完了した後、ドライバーは EtwUnregister 関数を呼び出してプロバイダーの登録を解除する必要があります。 EtwRegister を呼び出すたびに、EtwUnregister への対応する呼び出しが必要です。 イベント プロバイダーの登録解除に失敗すると、プロセスに関連付けられているコールバックが無効になったため、プロセスがアンロードされたときにエラーが発生する可能性があります。 EtwRegister 関数と EtwUnregister 関数で囲まれたコードの外側にあるトレース呼び出しを行う必要はありません。 最適なパフォーマンスを得るには、DriverEntry ルーチンで EtwRegister 関数を呼び出し、DriverUnload ルーチンで EtwUnregister 関数を呼び出すことができます。

EtwRegister の呼び出し元は、システム スレッドのコンテキストで IRQL = PASSIVE_LEVELで実行されている必要があります。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe;Ntdll.dll
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

こちらもご覧ください

EtwRegister