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 | 任意のレベル |