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