PFND3DDDI_SETDISPLAYPRIVATEDRIVERFORMATCB回呼函式 (d3dumddi.h)
pfnSetDisplayPrivateDriverFormatCb 函式會變更視訊簡訊簡訊的私人格式屬性。
語法
PFND3DDDI_SETDISPLAYPRIVATEDRIVERFORMATCB Pfnd3dddiSetdisplayprivatedriverformatcb;
HRESULT Pfnd3dddiSetdisplayprivatedriverformatcb(
HANDLE hDevice,
const D3DDDICB_SETDISPLAYPRIVATEDRIVERFORMAT *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄 (圖形內容) 。
unnamedParam2
pData [in]
D3DDDICB_SETDISPLAYPRIVATEDRIVERFORMAT 結構的指標，描述如何格式化影片呈現來源。
傳回值
pfnSetDisplayPrivateDriverFormatCb 會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| S_OK | 影片簡報來源已成功變更。 |
| E_INVALIDARG | 已驗證參數，並判斷為不正確。 |
| E_FAIL | pfnSetDisplayPrivateDriverFormatCb 無法變更影片簡報來源的私人格式屬性。 |
此函式也可能傳回其他 HRESULT 值。
備註
變更視訊簡訊簡報來源的私人格式屬性有助於容納全螢幕 DirectX 應用程式，以在共用 GDI 主要介面為全螢幕 DirectX 應用程式的非最佳私人格式時，建立其翻轉變更。 例如，假設顯示迷你埠驅動程式一律會建立 GDI 共用的主要表面作為未撥動。 不過，基於效能考慮，使用者模式顯示驅動程式會要求全螢幕翻轉鏈結中的所有表面都會撥動。 然後，使用者模式顯示驅動程式可以建立後台緩衝區，並呼叫 pfnSetDisplayPrivateDriverFormatCb ，將共用的 GDI 主要表面變更為撥動。
如果 呼叫 pfnSetDisplayPrivateDriverFormatCb 失敗，則使用者模式顯示驅動程式應該會繼續，而不需變更視訊簡訊的私人格式屬性。 在上述範例中，驅動程式可以將共用的主要複本保留為未撥動，並讓後台緩衝區撥動，或者驅動程式可以將後台緩衝區變更為未撥動的格式。
如果使用者模式顯示驅動程式從 呼叫 pfnSetDisplayModeCb 函式收到D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT錯誤，驅動程式可以執行下列其中一項：
- 變更主要介面的私人格式屬性，然後再次呼叫 pfnSetDisplayModeCb 。
- 呼叫 pfnSetDisplayPrivateDriverFormatCb ，並嘗試變更視訊簡訊簡訊的私人格式屬性。 驅動程式接著可以再次呼叫 pfnSetDisplayModeCb 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | 桌面 |
| 標頭 | d3dumddi.h (包含 D3dumddi.h) |