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

デバイスの作成を制御する 1 つ以上のオプションの組み合わせ ( D3DCREATE を参照)。

[in, out] pPresentationParameters

種類: D3DPRESENT_PARAMETERS*

作成するデバイスのプレゼンテーション パラメーターを記述する、 D3DPRESENT_PARAMETERS 構造体へのポインター。 BehaviorFlags でD3DCREATE_ADAPTERGROUP_DEVICEが指定されている場合、このパラメーターは配列です。 存在するヘッドの数に関係なく、1 つの深度/ステンシル サーフェスのみが自動的に作成されます。

このパラメーターは、入力パラメーターと出力パラメーターの両方です。 このメソッドを呼び出すと、次のようないくつかのメンバーが変更される場合があります。

• メソッドが呼び出される前に 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は、無効な呼び出し元入力以外のエラーが発生したときに返されます。

要件

関連項目

IDirect3D9Ex