HalFreeHardwareCounters-Funktion (ntddk.h)
Die HalFreeHardwareCounters Routine gibt eine Reihe von Hardwareleistungszählerressourcen frei, die in einem vorherigen Aufruf von HalAllocateHardwareCounters Routine abgerufen wurden.
Syntax
NTSTATUS HalFreeHardwareCounters(
_In_ HANDLE CounterSetHandle
);
Parameter
[in] CounterSetHandle
Ein Handle für die zugeordneten Leistungsindikatorenressourcen. Der Aufrufer hat dieses Handle in einem vorherigen Aufruf von HalAllocateHardwareCountersabgerufen.
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- kein gültiges Zählerressourcenhandle ist. |
Bemerkungen
Vor dem Aufrufen dieser Funktion wird erwartet, dass der Clienttreiber die zugeordneten Leistungsindikatorressourcen beendet und gelöscht wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | ntddk.h (enthalten Ntddk.h, Ntifs.h) |
| Library | Hal.lib |
| DLL- | Hal.dll |
| IRQL- | PASSIVE_LEVEL |