HalFreeHardwareCounters 関数 (ntddk.h)
HalFreeHardwareCounters ルーチンは、以前の HalAllocateHardwareCounters ルーチンの呼び出しで取得したハードウェア パフォーマンス カウンター リソースのセットを解放します。
構文
NTSTATUS HalFreeHardwareCounters(
_In_ HANDLE CounterSetHandle
);
パラメーター
[in] CounterSetHandle
割り当てられたカウンター リソースへのハンドル。 呼び出し元は、 以前の HalAllocateHardwareCounters の呼び出しでこのハンドルを取得しました。
戻り値
呼び出しが成功した場合、HalFreeHardwareCounters はSTATUS_SUCCESSを返します。 エラーの戻り値として考えられるのは、次のとおりです。
| リターン コード | 説明 |
|---|---|
| STATUS_INVALID_PARAMETER | Parameter CounterSetHandle は有効なカウンター リソース ハンドルではありません。 |
注釈
この関数を呼び出す前に、クライアント ドライバーは、関連付けられているカウンター リソースを停止してクリアする必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ntddk.h (Ntddk.h、Ntifs.h を含む) |
| Library | Hal.lib |
| [DLL] | Hal.dll |
| IRQL | PASSIVE_LEVEL |