WMIDPREQUEST コールバック関数 (evntrace.h)

[アーティクル]
08/23/2023

RegisterTraceGuids ベース ("クラシック") イベントプロバイダーは、コントローラーから有効または無効の通知要求を受信するために、この関数を実装します。

WMIDPREQUEST 型は、このコールバック関数へのポインターを定義します。 ControlCallback は、アプリケーション定義関数名のプレースホルダーです。

構文

WMIDPREQUEST Wmidprequest;

ULONG Wmidprequest(
  [in] WMIDPREQUESTCODE RequestCode,
       PVOID RequestContext,
       ULONG *BufferSize,
  [in] PVOID Buffer
)
{...}

パラメーター

[in] RequestCode

要求コード。これは、次のいずれかの値になります。

値	意味
WMI_ENABLE_EVENTS	プロバイダーまたは変更プロバイダーの構成を有効にします。
WMI_DISABLE_EVENTS	プロバイダーを無効にします。

RequestContext

プロバイダー定義のコンテキスト。プロバイダーは、の RequestContext パラメーターを使用します。
コンテキストを指定する RegisterTraceGuids。

BufferSize

内部使用のために予約されています。

[in] Buffer

プロバイダーが有効または無効になっているイベントトレースセッションに関する情報を含むWNODE_HEADER構造体へのポインター。

戻り値

コールバックが成功した場合は、ERROR_SUCCESSを返す必要があります。 ETW は、プロバイダーを有効にするためにコントローラーが EnableTrace を呼び出し、プロバイダーがまだ RegisterTraceGuids を呼び出していない場合を除き、この関数の戻り値を無視します。これが発生すると、登録が成功した場合、 RegisterTraceGuids はこのコールバックの戻り値を返します。

注釈

この関数は RegisterTraceGuids 関数を使用して指定します。コントローラーが EnableTrace 関数を呼び出して有効化フラグまたはレベルを有効、無効、または変更すると、ETW はこのコールバックを呼び出します。プロバイダーは 、RequestCode 値に基づいてそれ自体を有効または無効にします。通常、プロバイダーはこの値を使用して、有効な状態を示すグローバルフラグを設定します。

プロバイダーは、有効または無効の解釈を定義します。一般に、プロバイダーが有効になっている場合はイベントが生成されますが、無効になっている間は生成されません。

ETW は有効化フラグを渡せず、コントローラーがこのコールバックに EnableTrace 関数に渡すレベルを有効にします。この情報を取得するには、 GetTraceEnableFlags 関数と GetTraceEnableLevel 関数をそれぞれ呼び出します。

また、今後の呼び出しのために、このコールバックでセッションハンドルを取得する必要があります。セッションハンドルを取得するには、 GetTraceLoggerHandle 関数を呼び出します。

コールバック関数は、LoadLibrary が発生する可能性のあるもの (具体的にはローダーロックを必要とするもの) を呼び出してはなりません。

例

ControlCallback 関数の実装例については、「クラシックイベントの記述」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	evntrace.h