CounterInitialize 関数

プロバイダーを登録し、カウンター セットを初期化します。

構文

ULONG WINAPI CounterInitialize(void);

パラメーター

この関数にはパラメーターはありません。

戻り値

成功したERROR_SUCCESSを返します。それ以外の場合は、標準の Win32 エラー コード。

解説

プロバイダーはこの関数を呼び出します。 この関数には、 PerfStartProvider 関数と PerfSetCounterSetInfo 関数の呼び出しが含まれます。

-o 引数を指定すると、CTRPP ツールによってこのインライン関数が生成されます。 -prefix 引数を指定した場合、関数の名前にはプレフィックス文字列が含まれます。

-MemoryRoutines 引数または -NotificationCallback 引数を指定する (またはプロバイダー要素のコールバック属性を指定する) 場合、CounterInitialize シグネチャは次のように変更されます。

ULONG WINAPI CounterInitialize(
    __in_opt PERFLIBREQUEST NotificationCallback,
    __in_opt PERF_MEM_ALLOC MemoryAllocationFunction,
    __in_opt PERF_MEM_FREE MemoryFreeFunction,
    __inout_opt PVOID MemoryFunctionContext
);

パラメーターの説明

NotificationCallback

コンシューマー要求の通知を受け取るために実装する ControlCallback コールバック関数の名前 (クエリのカウンターを追加または削除する要求など)。 ControlCallback コールバック関数を実装しない場合は NULL に設定します。

MemoryAllocationFunction

メモリを 割り当てるため に PERFLIB によって呼び出される AllocateMemory コールバック関数の名前。 -MemoryRoutines 引数を指定しなかった場合は NULL に設定します。

MemoryFreeFunction

AllocateMemory 関数を使用して割り当てられたメモリを解放するために PERFLIB が呼び出す FreeMemory コールバック関数の名前。 MemoryAllocationFunction が NULL の場合は NULL に設定します。

MemoryFunctionContext

メモリ割り当ておよび空きルーチンに渡すコンテキスト情報。 NULL を指定できます。

必要条件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]