EtwEventEnabled 関数 (wdm.h)

EtwEventEnabled 関数は、イベントが有効になっているかどうかを確認します。

構文

BOOLEAN EtwEventEnabled(
  [in] REGHANDLE          RegHandle,
  [in] PCEVENT_DESCRIPTOR EventDescriptor
);

[in] RegHandle

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

[in] EventDescriptor

定数EVENT_DESCRIPTORへのポインター。

EtwEventEnabled 関数は、イベントが有効になっている場合は TRUE を返し、イベントが有効になっていない場合は FALSE を返します。

イベントのログ記録に追加のコンピューティングが必要な場合は、 EtwEventEnabled 関数を使用してイベントがログに記録されるかどうかを判断できます。これにより、ログ記録が無効になっている場合のオーバーヘッドが最小限に抑えられます。

イベント記述子が使用できない場合は、代わりに EtwProviderEnabled 関数を使用します。

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	任意のレベル