Função HalFreeHardwareCounters (ntddk.h)
A rotina HalFreeHardwareCounters libera um conjunto de recursos de contador de desempenho de hardware adquiridos em uma chamada anterior para rotina de HalAllocateHardwareCounters.
Sintaxe
NTSTATUS HalFreeHardwareCounters(
_In_ HANDLE CounterSetHandle
);
Parâmetros
[in] CounterSetHandle
Um identificador para os recursos de contador alocados. O chamador adquiriu esse identificador em uma chamada anterior para HalAllocateHardwareCounters.
Valor de retorno
HalFreeHardwareCounters retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Os valores de retorno de erro possíveis incluem o seguinte:
| Código de retorno | Descrição |
|---|---|
| STATUS_INVALID_PARAMETER | O parâmetro CounterSetHandle não é um identificador de recursos de contador válido. |
Observações
Antes de chamar essa função, espera-se que o driver cliente pare e limpe os recursos do contador associado.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 7 e versões posteriores do Windows. |
| da Plataforma de Destino | Universal |
| cabeçalho | ntddk.h (inclua Ntddk.h, Ntifs.h) |
| biblioteca | Hal.lib |
| de DLL | Hal.dll |
| IRQL | PASSIVE_LEVEL |