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 參數的輸入值，而且會透過 length 參數傳回包含終止 Null) 的對應字串長度 (。 當 length 和對應的參數都是非Null時，會檢查長度的輸入值以確保有足夠的空間，然後字串的長度 (包括終止 Null 字元) 會透過 length 參數傳遞。

規格需求

目標平台	Windows
標頭	d3d10.h
程式庫	D3D10.lib

另請參閱

ID3D10Device 介面