共用方式為


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