IDirect3D9Ex：：CreateDeviceEx 方法 (d3d9.h)

  • 發行項

建立代表顯示介面卡的裝置。

語法

HRESULT CreateDeviceEx(
  [in]          UINT                  Adapter,
  [in]          D3DDEVTYPE            DeviceType,
  [in]          HWND                  hFocusWindow,
  [in]          DWORD                 BehaviorFlags,
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [in, out]     D3DDISPLAYMODEEX      *pFullscreenDisplayMode,
  [out, retval] IDirect3DDevice9Ex    **ppReturnedDeviceInterface
);

參數

[in] Adapter

類型： UINT

代表顯示配接器的序數位。 D3DADAPTER_DEFAULT 一律是主要顯示介面卡。

[in] DeviceType

類型： D3DDEVTYPE

指定裝置的類型。 請參閱 D3DDEVTYPE。 如果所需的裝置類型無法使用，方法將會失敗。

[in] hFocusWindow

類型： HWND

當應用程式從前景模式切換到背景模式時，焦點視窗會警示 Direct3D。 針對全螢幕模式，指定的視窗必須是最上層視窗。 若為視窗模式 ，只有當 pPresentationParameters 的 hDeviceWindow 成員設定為有效的非 Null 值時，此參數才可為Null 。

[in] BehaviorFlags

類型： DWORD

一或多個選項的組合 (請參閱控制裝置建立的 D3DCREATE) 。

[in, out] pPresentationParameters

類型： D3DPRESENT_PARAMETERS*

D3DPRESENT_PARAMETERS結構的指標，描述要建立之裝置的簡報參數。 如果 BehaviorFlags 指定 D3DCREATE_ADAPTERGROUP_DEVICE，則此參數為數組。 不論存在的頭部數目為何，系統都會自動建立一個深度/樣板表面。

此參數同時是輸入和輸出參數。 呼叫此方法可能會變更數個成員，包括：

  • 如果呼叫 方法之前，BackBufferCount、BackBufferWidth 和 BackBufferHeight 為 0，則方法傳回時將會變更它們。
  • 如果在呼叫 方法之前，BackBufferFormat 等於 D3DFMT_UNKNOWN ，當方法傳回時，將會變更它。

[in, out] pFullscreenDisplayMode

類型： D3DDISPLAYMODEEX*

當裝置設定為全螢幕時的顯示模式。 請參閱 D3DDISPLAYMODEEX。 如果 BehaviorFlags 指定 D3DCREATE_ADAPTERGROUP_DEVICE，則此參數為數組。 此參數必須是視窗模式的 Null 。

[out, retval] ppReturnedDeviceInterface

類型： IDirect3DDevice9Ex**

所傳回 之 IDirect3DDevice9Ex指標的位址，代表已建立的裝置。

傳回值

類型： HRESULT

當轉譯裝置與交換鏈緩衝區成功建立時，這個方法會傳回S_OK。 當遇到無效呼叫端輸入以外的任何錯誤時，就會傳回D3DERR_DEVICELOST。

需求

   
目標平台 Windows
標頭 d3d9.h
程式庫 D3D9.lib

另請參閱

IDirect3D9Ex