HalFreeHardwareCounters, fonction (ntddk.h)
La routine HalFreeHardwareCounters libère un ensemble de ressources de compteur de performances matérielles acquises dans un appel précédent à HalAllocateHardwareCounters routine.
Syntaxe
NTSTATUS HalFreeHardwareCounters(
_In_ HANDLE CounterSetHandle
);
Paramètres
[in] CounterSetHandle
Handle pour les ressources de compteur allouées. L’appelant a acquis ce handle dans un appel précédent à HalAllocateHardwareCounters.
Valeur de retour
HalFreeHardwareCounters retourne STATUS_SUCCESS si l’appel a réussi. Les valeurs de retour d’erreur possibles sont les suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Le paramètre CounterSetHandle n’est pas un handle de ressources de compteur valide. |
Remarques
Avant d’appeler cette fonction, le pilote client est censé arrêter et effacer les ressources de compteur associées.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Ntddk.h, Ntifs.h) |
| bibliothèque | Hal.lib |
| DLL | Hal.dll |
| IRQL | PASSIVE_LEVEL |