DXGI_DDI_ARG_PRESENT1結構 (dxgiddi.h)
描述要顯示的資源。 搭配 Windows 顯示驅動程式模型 (WDDM) 1.3 和更新版本的使用者模式顯示驅動程式,搭配 pfnPresent1 (DXGI) 函式使用。
語法
typedef struct DXGI_DDI_ARG_PRESENT1 {
[in] DXGI_DDI_HDEVICE hDevice;
[in] const DXGI_DDI_ARG_PRESENTSURFACE *phSurfacesToPresent;
[in] UINT SurfacesToPresent;
[in] DXGI_DDI_HRESOURCE hDstResource;
[in] UINT DstSubResourceIndex;
[in] void *pDXGIContext;
[in] DXGI_DDI_PRESENT_FLAGS Flags;
[in] DXGI_DDI_FLIP_INTERVAL_TYPE FlipInterval;
UINT Reserved;
[in] const RECT *pDirtyRects;
[in] UINT DirtyRects;
UINT BackBufferMultiplicity;
} DXGI_DDI_ARG_PRESENT1;
成員
[in] hDevice
驅動程式執行簡報的顯示裝置 (圖形內容) 句柄。 當運行時間呼叫驅動程式的 CreateDevice (D3D10 ) 函式來建立顯示裝置時,Direct3D 運行時間會將此句柄傳遞給D3D10DDIARG_CREATEDEVICE結構的 hDrvDevice 成員中的驅動程式。
[in] phSurfacesToPresent
要顯示或釋放之來源資源的非 NULL 句柄和以零起始的索引數位。 phSurfacesToPresent 一律是要顯示之資源的有效句柄。
[in] SurfacesToPresent
要呈現的介面陣列。 不得為零。
[in] hDstResource
要顯示目的地資源的句柄。如果目的地未知, hDstResource 可以是 NULL ;核心模式會在透過 DMA 將硬體命令數據流傳送至圖形處理器之前判斷目的地。
呈現許多資源時, hDstResource 會是 NULL,而且驅動程式必須只轉譯最後一個來源資源句柄,才能與 pfnPresentCb 函式搭配使用。
[in] DstSubResourceIndex
以零起始的索引到目的地資源, hDstResource 成員中指定的句柄。 DstSubResourceIndex 索引會指出要顯示的子資源或表面。
[in] pDXGIContext
DXGI 內容的句柄。 此句柄對驅動程式不透明。 驅動程式必須在驅動程式呼叫 pfnPresentCbDXGIGI 函式時,將此成員中的句柄當做 DXGIDDICB_PRESENT 結構的 pDXGIContext 成員傳遞。
[in] Flags
識別位欄位旗標中如何執行目前作業的 DXGI_DDI_PRESENT_FLAGS 結構。
[in] FlipInterval
DXGI_DDI_FLIP_INTERVAL_TYPE型別值,表示翻轉間隔 (,也就是說,如果翻轉發生在零、一個、兩個、三個或四個垂直同步) 。
Reserved
這個成員是保留的,而且應該設定為零。
[in] pDirtyRects
相對於來源矩形 SrcRect, (RECT) 之中途矩形陣列的指標,表示已變更之重疊平面的部分。
驅動程式可以使用這個成員來執行優化,但不需要使用中途矩形資訊。 不過,驅動程式絕不會根據提供的中途矩形來失敗函數調用。
[in] DirtyRects
pDirtyRects 所指向之陣列中的中途矩形數目。
BackBufferMultiplicity
每個邏輯後端緩衝區的實體後台緩衝區數目。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8.1,WDDM 1.3 和更新版本 |
最低支援的伺服器 | Windows Server 2012 R2 |
標頭 | dxgiddi.h (包含 D3d10umddi.h) |