Método ID3D11Device::CheckCounter (d3d11.h)

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

Sintaxe

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

Parâmetros

[in] pDesc

Tipo: const D3D11_COUNTER_DESC*

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

[out] pType

Tipo: D3D11_COUNTER_TYPE*

Ponteiro para o tipo de dados de um contador (consulte D3D11_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, optional] 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, optional] pNameLength

Tipo: UINT*

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

[out, optional] 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, optional] pUnitsLength

Tipo: UINT*

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

[out, optional] 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, optional] 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 11.

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.

Windows Phone 8: há suporte para essa API.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	d3d11.h
Biblioteca	D3D11.lib

Confira também

ID3D11Device