Edit

HalFreeHardwareCounters function (ntddk.h)

  • Article

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

See also

HalAllocateHardwareCounters