共用方式為


PFND3D10DDI_CHECKCOUNTER回呼函式 (d3d10umddi.h)

CheckCounter 函式會擷取描述計數器的資訊。

語法

PFND3D10DDI_CHECKCOUNTER Pfnd3d10ddiCheckcounter;

void Pfnd3d10ddiCheckcounter(
            D3D10DDI_HDEVICE unnamedParam1,
            D3D10DDI_QUERY unnamedParam2,
            D3D10DDI_COUNTER_TYPE *unnamedParam3,
            UINT *unnamedParam4,
            LPSTR unnamedParam5,
  [in, out] UINT *pNameLength,
            LPSTR unnamedParam7,
  [in, out] UINT *pUnitsLength,
            LPSTR unnamedParam9,
  [in, out] UINT *pDescriptionLength
)
{...}

參數

unnamedParam1

hDevice [in]

顯示裝置的句柄(圖形內容)。

unnamedParam2

查詢 [in]

D3D10DDI_QUERY型別值,識別擷取資訊的計數器標識碼。

unnamedParam3

pCounterType [out]

從D3D10DDI_COUNTER_TYPE列舉接收下列其中一個值的變數指標,識別計數器所輸出的數據類型。

價值 意義
D3D10DDI_COUNTER_TYPE_FLOAT32 單精度浮點數
D3D10DDI_COUNTER_TYPE_UINT16 16 位值
D3D10DDI_COUNTER_TYPE_UINT32 32 位值
D3D10DDI_COUNTER_TYPE_UINT64 64 位值

unnamedParam4

pDescription [out]

驅動程式傳回NULL終止字串的指標,其中包含計數器標識碼所測量內容的描述。

unnamedParam5

pActiveCounters [out]

變數的指標,這個變數會接收同時作用中計數器的數目,這些計數器會配置給建立 Query 識別的計數器標識符。

[in, out] pNameLength

變數的指標,會接收 pName 參數所指定之 NULL 終止字串的大小,以位元組為單位。

unnamedParam7

pName [out]

驅動程式傳回NULL終止字串的指標,其中包含計數器標識碼的名稱。

[in, out] pUnitsLength

變數的指標,會接收 pUnits 參數所指定之 NULL 終止字串的大小,以位元組為單位。

unnamedParam9

pUnits [out]

驅動程式傳回NULL終止字串的指標,其中包含計數器標識碼所測量單位的名稱。

[in, out] pDescriptionLength

變數的指標,會接收 pDescription 參數所指定之 NULL 終止字串的大小,以位元組為單位。

傳回值

沒有

言論

驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。

驅動程式的 CheckCounter 函式可以呼叫 pfnSetErrorCb 回呼函式,如果 Query 參數 CheckCounter指定裝置不支援的已知計數器,則可以設定ERR_UNSUPPORTED錯誤碼。

驅動程式必須驗證裝置相依的計數器標識碼,以確保標識碼在範圍內。 驅動程式也必須確保有足夠的空間,將每個計數器字串複製到 direct3D 運行時間提供Microsoft的每個緩衝區。 驅動程式可以呼叫 pfnSetErrorCb pfnSetErrorCb 回呼函式,以在提供的任何緩衝區沒有足夠的空間時設定E_INVALIDARG錯誤碼。

驅動程式的 CheckCounter 函式無法 呼叫 pfnSetErrorCb 回呼函式來設定D3DDDIERR_DEVICEREMOVED錯誤碼,因為 CheckCounter 是函式的功能檢查類型。 驅動程式必須確保在裝置建立之後有足夠的資訊,以回應 CheckCounter的呼叫,即使存在D3DDDIERR_DEVICEREMOVED也是如此。

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
目標平臺 桌面
標頭 d3d10umddi.h (包括 D3d10umddi.h)

另請參閱

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb