Funzione HalFreeHardwareCounters (ntddk.h)
La routine HalFreeHardwareCounters libera un set di risorse del contatore delle prestazioni hardware acquisite in una chiamata precedente a HalAllocateHardwareCounters routine.
Sintassi
NTSTATUS HalFreeHardwareCounters(
_In_ HANDLE CounterSetHandle
);
Parametri
[in] CounterSetHandle
Handle per le risorse del contatore allocate. Il chiamante ha acquisito questo handle in una chiamata precedente a HalAllocateHardwareCounters.
Valore restituito
HalFreeHardwareCounters restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. I possibili valori restituiti dall'errore includono quanto segue:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Il parametro counterSetHandle non è un handle di risorse contatore valido. |
Osservazioni
Prima di chiamare questa funzione, il driver client deve arrestare e cancellare le risorse del contatore associate.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| piattaforma di destinazione | Universale |
| intestazione | ntddk.h (include Ntddk.h, Ntifs.h) |
| libreria | Hal.lib |
| dll | Hal.dll |
| IRQL | PASSIVE_LEVEL |