IDirect3DDevice9::CreateAdditionalSwapChain 方法 (d3d9.h)
建立用於轉譯多個檢視的其他交換鏈結。
語法
HRESULT CreateAdditionalSwapChain(
[in, out] D3DPRESENT_PARAMETERS *pPresentationParameters,
[out, retval] IDirect3DSwapChain9 **pSwapChain
);
參數
[in, out] pPresentationParameters
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 |