Método ID3D10Device::CheckCounter (d3d10.h)
Obtenga el tipo, el nombre, las unidades de medida y una descripción de un contador existente.
Sintaxis
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*
Puntero a una descripción del contador (consulte D3D10_COUNTER_DESC). Especifica qué información de contador se va a recuperar.
[out] pType
Tipo: D3D10_COUNTER_TYPE*
Puntero al tipo de datos de un contador (consulte D3D10_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] 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] pNameLength
Tipo: UINT*
Longitud de la cadena devuelta a szName. Puede ser NULL.
[out] 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] pUnitsLength
Tipo: UINT*
Longitud de la cadena devuelta a szUnits. Puede ser NULL.
[out] 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] 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 10.
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.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | d3d10.h |
| Library | D3D10.lib |