ID3D11Device：：CheckCounter 方法 (d3d11.h)

获取现有计数器的类型、名称、度量单位和说明。

语法

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
);

参数

[in] pDesc

类型： const D3D11_COUNTER_DESC*

指向计数器说明的指针 (查看 D3D11_COUNTER_DESC) 。 指定要检索的计数器信息。

[out] pType

类型： D3D11_COUNTER_TYPE*

指向计数器数据类型的指针 (请参阅 D3D11_COUNTER_TYPE) 。 指定要检索的计数器的数据类型。

[out] pActiveCounters

类型： UINT*

指向创建此计数器类型所需的硬件计数器数的指针。 同一计数器类型的所有实例都使用相同的硬件计数器。

[out, optional] szName

类型： LPSTR

要用计数器的简短名称填充的字符串。 如果应用程序对计数器的名称不感兴趣，则可能为 NULL 。

[in, out, optional] pNameLength

类型： UINT*

返回到 szName 的字符串的长度。 可以为 NULL。

[out, optional] szUnits

类型： LPSTR

计数器度量单位的名称，前提是指针指向的内存有足够的空间来保存字符串。 可以为 NULL。 返回的字符串将始终为英语。

[in, out, optional] pUnitsLength

类型： UINT*

返回给 szUnits 的字符串的长度。 可以为 NULL。

[out, optional] szDescription

类型： LPSTR

计数器的说明，前提是指针指向的内存有足够的空间来保存字符串。 可以为 NULL。 返回的字符串将始终为英语。

[in, out, optional] pDescriptionLength

类型： UINT*

返回到 szDescription 的字符串的长度。 可以为 NULL。

返回值

类型： HRESULT

此方法返回以下 Direct3D 11 返回代码之一。

注解

长度参数可以为 NULL，表示应用程序对长度和相应的字符串值不感兴趣。 当 length 参数为非 NULL 且相应的字符串为 NULL 时，将忽略 length 参数的输入值，并通过 length 参数返回相应字符串的长度 (包括终止 NULL) 。 当 length 和相应的参数都为非 NULL 时，将检查 length 的输入值以确保有足够的空间，然后通过 length 参数传递字符串 (包括终止 NULL 字符) 的长度。

Windows Phone 8：支持此 API。

要求

目标平台	Windows
标头	d3d11.h
Library	D3D11.lib

另请参阅

ID3D11Device