ID3D10Device::CheckCounter method (d3d10.h)
Get the type, name, units of measure, and a description of an existing counter.
Syntax
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
);
Parameters
[in] pDesc
Type: const D3D10_COUNTER_DESC*
Pointer to a counter description (see D3D10_COUNTER_DESC). Specifies which counter information is to be retrieved about.
[out] pType
Type: D3D10_COUNTER_TYPE*
Pointer to the data type of a counter (see D3D10_COUNTER_TYPE). Specifies the data type of the counter being retrieved.
[out] pActiveCounters
Type: UINT*
Pointer to the number of hardware counters that are needed for this counter type to be created. All instances of the same counter type use the same hardware counters.
[out] szName
Type: LPSTR
String to be filled with a brief name for the counter. May be NULL if the application is not interested in the name of the counter.
[in, out] pNameLength
Type: UINT*
Length of the string returned to szName. Can be NULL.
[out] szUnits
Type: LPSTR
Name of the units a counter measures, provided the memory the pointer points to has enough room to hold the string. Can be NULL. The returned string will always be in English.
[in, out] pUnitsLength
Type: UINT*
Length of the string returned to szUnits. Can be NULL.
[out] szDescription
Type: LPSTR
A description of the counter, provided the memory the pointer points to has enough room to hold the string. Can be NULL. The returned string will always be in English.
[in, out] pDescriptionLength
Type: UINT*
Length of the string returned to szDescription. Can be NULL.
Return value
Type: HRESULT
This method returns one of the following Direct3D 10 Return Codes.
Remarks
Length parameters can be NULL, which indicates the application is not interested in the length nor the corresponding string value. When a length parameter is non-NULL and the corresponding string is NULL, the input value of the length parameter is ignored, and the length of the corresponding string (including terminating NULL) will be returned through the length parameter. When length and the corresponding parameter are both non-NULL, the input value of length is checked to ensure there is enough room, and then the length of the string (including terminating NULL character) is passed out through the length parameter.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | d3d10.h |
| Library | D3D10.lib |