DXGI_DDI_ARG_PRESENT1結構 (dxgiddi.h)

發行項
02/29/2024

描述要顯示的資源。搭配 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)