共用方式為


PFND3D10DDI_QUERYBEGIN回呼函式 (d3d10umddi.h)

QueryBegin 函式會標記查詢之圖形命令序列的開頭,並將查詢轉換為「建置」狀態。

語法

PFND3D10DDI_QUERYBEGIN Pfnd3d10ddiQuerybegin;

void Pfnd3d10ddiQuerybegin(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HQUERY unnamedParam2
)
{...}

參數

unnamedParam1

hDevice [in]

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

unnamedParam2

hQuery [in]

要開始之查詢物件的句柄。

傳回值

沒有

言論

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

驅動程式不需要支援D3D10DDI_QUERY_EVENT或D3D10DDI_QUERY_TIMESTAMP查詢作業的 QueryBegin 函式。 這類查詢作業有隱含的開頭。

Microsoft Direct3D 運行時間無法透過呼叫 SetPredication 函式,在目前系結至管線的述詞上呼叫 queryBegin

除了D3DDDIERR_DEVICEREMOVED以外,驅動程式不應該發生任何錯誤。 因此,如果驅動程式通過任何錯誤,除了 D3DDDIERR_DEVICEREMOVED 之外,在呼叫 pfnSetErrorCb 函式時,Direct3D 運行時間會判斷錯誤是否重要。 即使移除裝置,驅動程式也不需要傳回D3DDDIERR_DEVICEREMOVED;不過,如果裝置移除干擾了 QueryBegin 的作業(通常不應該發生),驅動程式可以傳回D3DDDIERR_DEVICEREMOVED。

要求

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

另請參閱

D3D10DDI_DEVICEFUNCS

QueryEnd

SetPredication

pfnSetErrorCb