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

Windows Phone 8：支援此 API。

規格需求

目標平台	Windows
標頭	d3d11.h
程式庫	D3D11.lib

另請參閱

ID3D11Device