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

Obtenga el tipo, el nombre, las unidades de medida y una descripción de un contador existente.

Sintaxis

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*

Puntero a una descripción del contador (vea D3D11_COUNTER_DESC). Especifica qué información de contador se va a recuperar.

[out] pType

Tipo: D3D11_COUNTER_TYPE*

Puntero al tipo de datos de un contador (consulte D3D11_COUNTER_TYPE). Especifica el tipo de datos del contador que se va a recuperar.

[out] pActiveCounters

Tipo: UINT*

Puntero al número de contadores de hardware necesarios para crear este tipo de contador. Todas las instancias del mismo tipo de contador usan los mismos contadores de hardware.

[out, optional] szName

Tipo: LPSTR

Cadena que se va a rellenar con un nombre breve para el contador. Puede ser NULL si la aplicación no está interesada en el nombre del contador.

[in, out, optional] pNameLength

Tipo: UINT*

Longitud de la cadena devuelta a szName. Puede ser NULL.

[out, optional] szUnits

Tipo: LPSTR

Nombre de las unidades que mide un contador, siempre que la memoria a la que apunta el puntero tenga suficiente espacio para contener la cadena. Puede ser NULL. La cadena devuelta siempre estará en inglés.

[in, out, optional] pUnitsLength

Tipo: UINT*

Longitud de la cadena devuelta a szUnits. Puede ser NULL.

[out, optional] szDescription

Tipo: LPSTR

Una descripción del contador, siempre que la memoria a la que apunta el puntero tenga suficiente espacio para contener la cadena. Puede ser NULL. La cadena devuelta siempre estará en inglés.

[in, out, optional] pDescriptionLength

Tipo: UINT*

Longitud de la cadena devuelta a szDescription. Puede ser NULL.

Valor devuelto

Tipo: HRESULT

Este método devuelve uno de los siguientes códigos de retorno de Direct3D 11.

Comentarios

Los parámetros length pueden ser NULL, lo que indica que la aplicación no está interesada en la longitud ni en el valor de cadena correspondiente. Cuando un parámetro length es distinto de NULL y la cadena correspondiente es NULL, se omite el valor de entrada del parámetro length y la longitud de la cadena correspondiente (incluida la terminación NULL) se devolverá a través del parámetro length. Cuando length y el parámetro correspondiente no son NULL, se comprueba el valor de entrada de length para asegurarse de que hay suficiente espacio y, a continuación, la longitud de la cadena (incluido el carácter NULL de terminación) se pasa a través del parámetro length.

Windows Phone 8: se admite esta API.

Requisitos

Plataforma de destino	Windows
Encabezado	d3d11.h
Library	D3D11.lib

Consulte también

ID3D11Device