ID3D10Device：：CheckCounter 方法 (d3d10.h)

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

语法

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

参数

[in] pDesc

类型： const D3D10_COUNTER_DESC*

指向计数器说明的指针 (请参阅 D3D10_COUNTER_DESC) 。 指定要检索的计数器信息。

[out] pType

类型： D3D10_COUNTER_TYPE*

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

[out] pActiveCounters

类型： UINT*

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

[out] szName

类型： LPSTR

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

[in, out] pNameLength

类型： UINT*

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

[out] szUnits

类型： LPSTR

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

[in, out] pUnitsLength

类型： UINT*

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

[out] szDescription

类型： LPSTR

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

[in, out] pDescriptionLength

类型： UINT*

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

返回值

类型： HRESULT

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

注解

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

要求

目标平台	Windows
标头	d3d10.h
Library	D3D10.lib

另请参阅

ID3D10Device 接口