PcwUnregister 関数 (wdm.h)
関数は PcwUnregister
、指定されたカウンターセット登録を閉じます。 ほとんどの開発者は、この関数を直接呼び出す代わりに 、CTRPP によって生成された UnregisterXxx 関数を使用します。
構文
void PcwUnregister(
PPCW_REGISTRATION Registration
);
パラメーター
Registration
[in A pointer to the registration being closed.
戻り値
なし
解説
関数は PcwUnregister
、指定されたカウンターセット登録を閉じます。 カウンターセット登録によって所有されているインスタンスは自動的に閉じられます。 カウンターセットの登録が解除されている間、またはカウンターセットの登録が解除された後に、これらのインスタンスにプロバイダーからアクセスしないでください。
プロバイダーがこの関数を使用する前に、プロバイダーは PcwRegister 関数を呼び出して登録を作成する必要があります。
CTRPP によって生成された UnregisterXxx 関数
ほとんどの開発者は、 を直接呼び出す PcwUnregister
必要はありません。 代わりに、CTRPP ツールを使用してマニフェストをコンパイルし、CTRPP によって生成されたヘッダーから UnregisterXxx 関数を使用します。 生成された関数は次のようになります。
EXTERN_C FORCEINLINE VOID
UnregisterMyCounterset(
VOID
)
{
PAGED_CODE();
PcwUnregister(MyCounterset);
}
CTRPP によって生成された Unregister 関数には、 PrefixUnregister CounterSet という名前が付けられます。 プレフィックス は通常は空白ですが、パラメーターが -prefix
CTRPP コマンド ラインで使用された場合は存在する可能性があります。 CounterSet は、マニフェストで指定されているカウンターセットの名前です。 関数は Counterset 変数 (MyCounterset
この例では ) を参照します。これは、CTRPP によって生成された RegisterXxx 関数によって初期化されたカウンターセット登録ハンドルを保持するグローバル変数です。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | wdm.h (Wdm.h、Ntddk.h を含む) |
Library | NtosKrnl.lib |
[DLL] | NtosKrnl.exe |
IRQL | IRQL <= APC_LEVEL |