Compartilhar via


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

Consulte também

HalAllocateHardwareCounters