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列舉中接收下列其中一個值的變數指標。

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的 Query 參數指定了裝置不支援的已知計數器，驅動程式的 CheckCounter 函式可以呼叫 pfnSetErrorCb 回呼函式來設定ERR_UNSUPPORTED錯誤碼。

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

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

規格需求

另請參閱

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb