Método ID3D10Device::CheckCounter (d3d10.h)

Obtenha o tipo, o nome, as unidades de medida e uma descrição de um contador existente.

Sintaxe

HRESULT CheckCounter(
  [in]      const D3D10_COUNTER_DESC *pDesc,
  [out]     D3D10_COUNTER_TYPE       *pType,
  [out]     UINT                     *pActiveCounters,
  [out]     LPSTR                    szName,
  [in, out] UINT                     *pNameLength,
  [out]     LPSTR                    szUnits,
  [in, out] UINT                     *pUnitsLength,
  [out]     LPSTR                    szDescription,
  [in, out] UINT                     *pDescriptionLength
);

Parâmetros

[in] pDesc

Tipo: const D3D10_COUNTER_DESC*

Ponteiro para uma descrição do contador (consulte D3D10_COUNTER_DESC). Especifica sobre quais informações de contador devem ser recuperadas.

[out] pType

Tipo: D3D10_COUNTER_TYPE*

Ponteiro para o tipo de dados de um contador (consulte D3D10_COUNTER_TYPE). Especifica o tipo de dados do contador que está sendo recuperado.

[out] pActiveCounters

Tipo: UINT*

Ponteiro para o número de contadores de hardware necessários para que esse tipo de contador seja criado. Todas as instâncias do mesmo tipo de contador usam os mesmos contadores de hardware.

[out] szName

Tipo: LPSTR

Cadeia de caracteres a ser preenchida com um nome breve para o contador. Pode ser NULL se o aplicativo não estiver interessado no nome do contador.

[in, out] pNameLength

Tipo: UINT*

Comprimento da cadeia de caracteres retornada para szName. Pode ser NULL.

[out] szUnits

Tipo: LPSTR

Nome das unidades que um contador mede, desde que a memória para a qual o ponteiro aponta tenha espaço suficiente para manter a cadeia de caracteres. Pode ser NULL. A cadeia de caracteres retornada sempre estará em inglês.

[in, out] pUnitsLength

Tipo: UINT*

Comprimento da cadeia de caracteres retornada para szUnits. Pode ser NULL.

[out] szDescription

Tipo: LPSTR

Uma descrição do contador, desde que a memória para a qual o ponteiro aponta tenha espaço suficiente para manter a cadeia de caracteres. Pode ser NULL. A cadeia de caracteres retornada sempre estará em inglês.

[in, out] pDescriptionLength

Tipo: UINT*

Comprimento da cadeia de caracteres retornada para szDescription. Pode ser NULL.

Valor retornado

Tipo: HRESULT

Esse método retorna um dos seguintes códigos de retorno do Direct3D 10.

Comentários

Os parâmetros de comprimento podem ser NULL, o que indica que o aplicativo não está interessado no comprimento nem no valor da cadeia de caracteres correspondente. Quando um parâmetro de comprimento não for NULL e a cadeia de caracteres correspondente for NULL, o valor de entrada do parâmetro length será ignorado e o comprimento da cadeia de caracteres correspondente (incluindo a terminação NULL) será retornado por meio do parâmetro length. Quando length e o parâmetro correspondente são não NULL, o valor de entrada de length é verificado para garantir que haja espaço suficiente e, em seguida, o comprimento da cadeia de caracteres (incluindo o caractere NULL de terminação) é passado por meio do parâmetro length.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	d3d10.h
Biblioteca	D3D10.lib

Confira também

ID3D10Device Interface