PFND3DDDI_ESCAPECB回呼函式 (d3dumddi.h)
pfnEscapeCb 回呼函式會與顯示迷你埠驅動程式共用資訊。
語法
PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;
HRESULT Pfnd3dddiEscapecb(
HANDLE hAdapter,
const D3DDDICB_ESCAPE *unnamedParam2
)
{...}
參數
hAdapter
圖形配接器物件的句柄。
unnamedParam2
pData [in, out]
描述共享資訊 之D3DDDICB_ESCAPE 結構的指標。
傳回值
pfnEscapeCb 會傳回下列其中一個值:
傳回碼 | 描述 |
---|---|
S_OK | 已成功共享資訊。 |
E_OUTOFMEMORY | pfnEscapeCb 無法完成,因為記憶體不足。 |
E_INVALIDARG | 已驗證參數,並判斷為不正確。 |
D3DDDIERR_DEVICEREMOVED | pfnEscapeCb 無法起始對顯示器迷你埠驅動程式 DxgkDdiEscape 函式的呼叫,因為發生 隨插即用 (PnP) 停止或逾時偵測和復原 (TDR) 事件。 呼叫 pfnEscapeCb 的使用者模式顯示驅動程式函式必須將此錯誤碼傳回至 Direct3D 運行時間。 Direct3D 第 9 版 注意:如需傳回錯誤碼的詳細資訊,請參閱 傳回從運行時間函式收到的錯誤碼。 Direct3D 版本 10 和 11 注意:如果驅動程式函式未傳回值 (亦即,傳回參數類型為 void) ,驅動程式函式會呼叫 pfnSetErrorCb 函式,將錯誤碼傳回運行時間。 如需處理錯誤碼的詳細資訊,請參閱 處理錯誤。 |
此函式也可能傳回其他 HRESULT 值。
備註
使用者模式顯示驅動程式會呼叫 pfnEscapeCb ,以任何其他驅動程式通訊不支援的方式,與顯示器迷你埠驅動程序共用其他資訊。 使用者模式顯示驅動程式可以將其他資訊傳送至顯示迷你埠驅動程式,也可以從顯示迷你埠驅動程式擷取資訊。
Direct3D 版本 11 附注: 如需驅動程式如何呼叫 pfnEscapeCb 的詳細資訊,請參閱 Direct3D 10 的變更。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
目標平台 | 桌面 |
標頭 | d3dumddi.h (包含 D3dumddi.h) |