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