IDirect3DDevice9：：CreateAdditionalSwapChain 方法 (d3d9.h)

  • 發行項

建立用於轉譯多個檢視的其他交換鏈結。

語法

HRESULT CreateAdditionalSwapChain(
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [out, retval] IDirect3DSwapChain9   **pSwapChain
);

參數

[in, out] pPresentationParameters

類型： D3DPRESENT_PARAMETERS*

D3DPRESENT_PARAMETERS結構的指標，其中包含新交換鏈結的呈現參數。 這個值不可以是 Null。

呼叫這個方法會變更D3DPRESENT_PARAMETERS結構的成員值。

  • 如果 BackBufferCount == 0，則呼叫 CreateAdditionalSwapChain 會將它增加為 1。
  • 如果應用程式處於視窗模式，而且如果 BackBufferWidth 或 BackBufferHeight == 0，則會將其設定為 hwnd 的工作區寬度和高度。

[out, retval] pSwapChain

類型： IDirect3DSwapChain9**

IDirect3DSwapChain9介面指標的位址，代表其他交換鏈結。

傳回值

類型： HRESULT

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

備註

每個裝置一律至少有一個交換鏈結 (隱含交換鏈結) ，因為 Direct3D 9 有一個交換鏈結作為裝置的屬性。

請注意，任何指定的裝置只能支援一個全螢幕交換鏈結。

呼叫IDirect3D9：：CreateDevice、IDirect3DDevice9：：Reset和 CreateAdditionalSwapChain 時，可以針對視窗模式背景緩衝區格式指定D3DFMT_UNKNOWN。 這表示應用程式不需要在呼叫 CreateDevice 進行視窗模式之前查詢目前的桌面格式。 針對全螢幕模式，必須指定背景緩衝區格式。

需求

   
目標平台 Windows
標頭 d3d9.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9

以視窗模式呈現多個檢視， (Direct3D 9)