Share via

IDirect3D9Ex::CreateDeviceEx

  • [アーティクル]

ディスプレイ アダプターを表すデバイスを作成します。

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

パラメータ

  • Adapter
    クエリするディスプレイ アダプターを示す序数。D3DADAPTER_DEFAULT は常にプライマリ ディスプレイ アダプターです。
  • DeviceType
    デバイスの種類を指定します。「D3DDEVTYPE」を参照してください。目的のデバイス タイプが使用できない場合、メソッドは失敗します。
  • hFocusWindow
    アプリケーションでフォアグラウンド モードからバックグラウンド モードに切り替えるときに、フォーカス ウィンドウは Direct3D に警告を通知します。フルスクリーン モードの場合、指定されたウィンドウは最上位ウィンドウである必要があります。ウィンドウ表示モードの場合、pPresentationParameters の hDeviceWindow メンバーを NULL 以外の有効な値に設定した場合のみ、このパラメーターに NULL を指定できます。
  • BehaviorFlags
    デバイスの作成を制御する 1 つ以上のオプション (「D3DCREATE」を参照してください) の組み合わせです。
  • pPresentationParameters
    D3DPRESENT_PARAMETERS 構造体へのポインターです。作成するデバイスのプレゼンテーション パラメーターを記述します。BehaviorFlags で D3DCREATE_ADAPTERGROUP_DEVICE を指定した場合、このパラメーターは配列です。存在するヘッド数に関係なく、1 つの深度/ステンシル サーフェスが自動的に作成されます。 このパラメーターは、入力および出力パラメーターです。このメソッドを呼び出すと、以下のように複数のメンバーが変更される可能性があります。
  • pFullscreenDisplayMode
    デバイスがフルスクリーンに設定されているときのデバイス モードです。「D3DDISPLAYMODEEX」を参照してください。BehaviorFlags で D3DCREATE_ADAPTERGROUP_DEVICE を指定した場合、このパラメーターは配列です。
  • ppReturnedDeviceInterface
    返された IDirect3DDevice9Ex へのポインターのアドレス。作成されたデバイスを示します。

戻り値

このメソッドは、レンダリング デバイスがスワップ チェーン バッファーと共に正常に作成されたときに S_OK を返します。無効な呼び出し側入力以外のエラーが検出された場合は、D3DERR_DEVICELOST が返されます。

要件

ヘッダー: D3d9.h 宣言

ライブラリ: D3D9.lib 内容

関連項目

IDirect3D9Ex