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 (include D3d10umddi.h) |