PFND3DDDI_GETQUERYDATA回呼函式 (d3dumddi.h)
GetQueryData 函式會擷取查詢的相關信息。
語法
PFND3DDDI_GETQUERYDATA Pfnd3dddiGetquerydata;
HRESULT Pfnd3dddiGetquerydata(
HANDLE hDevice,
const D3DDDIARG_GETQUERYDATA *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄 (圖形內容) 。
unnamedParam2
pData [in, out]
D3DDDIARG_GETQUERYDATA 結構的指標,其中包含從驅動程式擷取之查詢的相關信息。
傳回值
GetQueryData 會傳回下列其中一個值:
傳回碼 | 描述 |
---|---|
S_OK | 查詢作業已完成,且查詢結果可供使用。 |
S_FALSE | 已成功傳回 GetQueryData。 不過,查詢作業未完成,因此查詢結果無法使用。 |
E_OUTOFMEMORY | GetQueryData 無法配置所需的記憶體,使其完成。 |
備註
在呼叫使用者模式顯示驅動程式的 IssueQuery 函式之後,Microsoft Direct3D 運行時間可以隨時呼叫 GetQueryData。 使用者模式顯示驅動程式應該根據儲存在驅動程式私人查詢結構中的值來檢查目前的柵欄值,以判斷查詢問題是否完成。
如果查詢已完成,驅動程式應該會傳回S_OK;否則,驅動程式應該會傳回S_FALSE。
如果驅動程式支援 運行時間處理的多重處理器優化 ,並公開0x0000000B或更新版本的 DDI 版本,運行時間會以重新進入的方式呼叫 GetQueryData 。 驅動程式會在呼叫驅動程式的 OpenAdapter 函式時,傳回 D3D10DDIARG_OPENADAPTER 結構的 DriverVersion 成員中的 DDI 版本值。 當運行時間以重新進入的方式呼叫 GetQueryData 時,一個線程可以在 GetQueryData 內執行,而另一個參考相同顯示裝置的線程會在另一個使用者模式顯示驅動程式函式內執行。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
目標平台 | 桌面 |
標頭 | d3dumddi.h (包含 D3dumddi.h) |