HalFreeHardwareCounters function (ntddk.h)
The HalFreeHardwareCounters routine frees a set of hardware performance counter resources that was acquired in a previous call to HalAllocateHardwareCounters routine.
Syntax
NTSTATUS HalFreeHardwareCounters(
_In_ HANDLE CounterSetHandle
);
Parameters
[in] CounterSetHandle
A handle to the allocated counter resources. The caller acquired this handle in a previous call to HalAllocateHardwareCounters.
Return value
HalFreeHardwareCounters returns STATUS_SUCCESS if the call was successful. Possible error return values include the following:
| Return code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Parameter CounterSetHandle is not a valid counter resources handle. |
Remarks
Before calling this function, the client driver is expected to stop and clear the associated counter resources.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 7 and later versions of Windows. |
| Target Platform | Universal |
| Header | ntddk.h (include Ntddk.h, Ntifs.h) |
| Library | Hal.lib |
| DLL | Hal.dll |
| IRQL | PASSIVE_LEVEL |