IDirect3DSwapChain9：:P resent 方法 (d3d9helper.h)

  • 發行項

在交換鏈結所擁有的後端緩衝區序列中呈現下一個緩衝區的內容。

語法

HRESULT Present(
  [in] const RECT    *pSourceRect,
  [in] const RECT    *pDestRect,
  [in] HWND          hDestWindowOverride,
  [in] const RGNDATA *pDirtyRegion,
  [in] DWORD         dwFlags
);

參數

[in] pSourceRect

類型： const RECT*

來源矩形的指標 (請參閱 RECT) 。 使用 NULL 呈現整個表面。 除非使用 D3DSWAPEFFECT_COPY 建立交換鏈結，否則此值必須是 NULL 。 如果矩形超過來源介面，矩形就會裁剪到來源介面。

[in] pDestRect

類型： const RECT*

用戶端座標中目的地矩形的指標 (請參閱 RECT) 。 除非使用 D3DSWAPEFFECT_COPY 建立交換鏈結，否則此值必須是 NULL 。 使用 NULL 填滿整個工作區。 如果矩形超過目的地工作區，則會將矩形裁剪到目的地工作區。

[in] hDestWindowOverride

類型： HWND

目的地視窗，其工作區會作為此簡報的目標。 如果此值為 NULL，運行時間會針對簡報使用 D3DPRESENT_PARAMETERS 的 hDeviceWindow 成員。

[in] pDirtyRegion

類型： const RGNDATA*

除非使用 D3DSWAPEFFECT_COPY 建立交換鏈結，否則此值必須是 NULL。 請參閱 翻轉 Surface (Direct3D 9) 。

如果此值為非 NULL，則包含的區域會以後端緩衝區座標表示。 區域內的矩形是需要更新的最小圖元集。 此方法會將這些矩形納入考慮，方法是只複製區域內的圖元，或一些適當展開的矩形集來優化簡報。 這隻是優化輔助功能，應用程式不應該完全依賴複製的區域。 實作可以選擇複製整個來源矩形。

[in] dwFlags

類型： DWORD

允許應用程式要求方法在驅動程式回報無法排程簡報時立即傳回。 有效值為 0，或 D3DPRESENT_DONOTWAIT 或 D3DPRESENT_LINEAR_CONTENT的任何組合。

  • 如果 dwFlags = 0，這個方法的行為就如同 Direct3D 9 之前一樣。 目前會旋轉直到硬體可用為止，而不會傳回錯誤。
  • 如果 dwFlags = D3DPRESENT_DONOTWAIT，且硬體正在忙碌處理或等候垂直同步間隔，則方法會傳回D3DERR_WASSTILLDRAWING。
  • 如果 dwFlags = D3DPRESENT_LINEAR_CONTENT，則會針對窗口交換鏈結從線性空間到 sRGB 執行 gamma 校正。 只有在驅動程序公開 D3DCAPS3_LINEAR_TO_SRGB_PRESENTATION ( 查看 Gamma (Direct3D 9) ) 時，此旗標才會生效。 如果反緩衝器格式為16位浮點，則應用程式應該指定此旗標，以便比對呈現為全螢幕 gamma 行為的視窗模式。

傳回值

類型： HRESULT

如果方法成功，傳回值會D3D_OK。 如果方法失敗，傳回值可以是下列其中一項：D3DERR_DEVICELOST、D3DERR_DRIVERINTERNALERROR、D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY。

備註

Present 方法是 Present 的快捷方式。 目前已更新為採用旗標，讓應用程式在驅動程式回報無法排程簡報時，要求方法立即傳回。

如有必要，會套用延展作業，將來源矩形內的像素傳送至目標視窗工作區中的目的地矩形。

如果 BeginScene 與 EndScene 配對之間呼叫，除非轉譯目標不是目前的轉譯目標，否則呈現將會失敗 (例如您從建立其他交換鏈結) 取得的後端緩衝區。 這是 Direct3D 9 的新行為。

規格需求

需求 值
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DSwapChain9

重設