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