HalFreeHardwareCounters-Funktion (ntddk.h)
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 |