Função HalFreeHardwareCounters (ntddk.h)

A rotina HalFreeHardwareCounters libera um conjunto de recursos de contador de desempenho de hardware que foi adquirido em uma chamada anterior para a rotina HalAllocateHardwareCounters .

Sintaxe

NTSTATUS HalFreeHardwareCounters(
  _In_ HANDLE CounterSetHandle
);

Parâmetros

[in] CounterSetHandle

Um identificador para os recursos do contador alocado. O chamador adquiriu esse identificador em uma chamada anterior para HalAllocateHardwareCounters.

Retornar valor

HalFreeHardwareCounters retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Os possíveis valores retornados por erro incluem o seguinte:

Código de retorno Descrição
STATUS_INVALID_PARAMETER CounterSetHandle de parâmetro não é um identificador de recursos de contador válido.

Comentários

Antes de chamar essa função, espera-se que o driver do cliente pare e limpe os recursos do contador associados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 7 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho ntddk.h (inclua Ntddk.h, Ntifs.h)
Biblioteca Hal.lib
DLL Hal.dll
IRQL PASSIVE_LEVEL

Confira também

HalAllocateHardwareCounters