HalFreeHardwareCounters-Funktion (ntddk.h)

  • Artikel

Die HalFreeHardwareCounters-Routine gibt eine Reihe von Hardwareleistungsindikatorressourcen frei, die in einem vorherigen Aufruf der HalAllocateHardwareCounters-Routine abgerufen wurden.

Syntax

NTSTATUS HalFreeHardwareCounters(
  _In_ HANDLE CounterSetHandle
);

Parameter

[in] CounterSetHandle

Ein Handle für die zugeordneten Zählerressourcen. Der Aufrufer hat dieses Handle in einem vorherigen Aufruf von HalAllocateHardwareCounters erworben.

Rückgabewert

HalFreeHardwareCounters gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Mögliche Fehlerrückgabewerte sind:

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER Parameter CounterSetHandle ist kein gültiges Indikatorressourcenhandle.

Hinweise

Vor dem Aufrufen dieser Funktion wird erwartet, dass der Clienttreiber die zugeordneten Zählerressourcen beendet und löscht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 7 und späteren Windows-Versionen.
Zielplattform Universell
Header ntddk.h (include Ntddk.h, Ntifs.h)
Bibliothek Hal.lib
DLL Hal.dll
IRQL PASSIVE_LEVEL

Weitere Informationen

HalAllocateHardwareCounters