IDirect3D9::CreateDevice メソッド (d3d9helper.h)

[アーティクル]
08/23/2023

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

構文

HRESULT CreateDevice(
  [in]          UINT                  Adapter,
  [in]          D3DDEVTYPE            DeviceType,
  [in]          HWND                  hFocusWindow,
  [in]          DWORD                 BehaviorFlags,
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [out, retval] IDirect3DDevice9      **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が指定されている場合、pPresentationParameters は配列です。存在するヘッドの数に関係なく、1 つの深度/ステンシルサーフェスのみが自動的に作成されます。

Windows 2000 および Windows XP の場合、全画面表示デバイスの表示更新レートは次の順序で設定されます。

デバイスでサポートされている場合は、ユーザー指定の 0 以外の ForcedRefreshRate レジストリキー。
プレゼンテーションパラメーターのアプリケーション指定の 0 以外の更新レート値。
デバイスでサポートされている場合は、最新のデスクトップの更新レート。
デバイスでサポートされている場合は 75 ヘルツ。
デバイスでサポートされている場合は 60 ヘルツ。
デバイスの既定値。

サポートされていない更新レートは、既定でサポートされている最も近い更新レートの下に設定されます。たとえば、アプリケーションで 63 ヘルツが指定されている場合は、60 ヘルツが使用されます。 57 ヘルツ未満の更新レートはサポートされていません。

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

メソッドが呼び出される前に BackBufferCount、BackBufferWidth、および BackBufferHeight が 0 の場合、メソッドが戻るときに変更されます。
メソッドが呼び出される前に BackBufferFormat がD3DFMT_UNKNOWN に等しい場合、メソッドが戻るときに変更されます。

[out, retval] ppReturnedDeviceInterface

種類: IDirect3DDevice9**

作成されたデバイスを表す、返された IDirect3DDevice9 インターフェイスへのポインターのアドレス。

戻り値

型: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_DEVICELOST、D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY。

解説

このメソッドは、完全に動作するデバイスインターフェイスを返し、必要な表示モード (またはウィンドウ表示) に設定し、適切なバックバッファーで割り当てられます。レンダリングを開始するには、アプリケーションで深度バッファーを作成して設定するだけで済みます (D3DPRESENT_PARAMETERSで EnableAutoDepthStencil が FALSE であると仮定します)。

Direct3D デバイスを作成するときは、フォーカスウィンドウ (hFocusWindow) とデバイスウィンドウ ( D3DPRESENT_PARAMETERSの hDeviceWindow) という 2 つの異なるウィンドウパラメーターを指定します。各ウィンドウの目的は次のとおりです。

フォーカスウィンドウは、アプリケーションがフォアグラウンドモードからバックグラウンドモードに切り替わると Direct3D に通知します (Alt キーを押しながら Tab キーを押すか、マウスをクリックするか、またはその他の方法を使用します)。 1 つのフォーカスウィンドウは、アプリケーションによって作成された各デバイスによって共有されます。
デバイスウィンドウは、画面上のバックバッファーの場所とサイズを決定します。これは、バックバッファーの内容が Present の間にフロントバッファーにコピーされるときに Direct3D によって使用されます。

このメソッドは、WM_CREATEの処理中に実行しないでください。アプリケーションは、WM_CREATEの処理中にウィンドウハンドルを Direct3D に渡すべきではありません。デバイスを作成、解放、またはリセットする呼び出しは、フォーカスウィンドウのウィンドウプロシージャと同じスレッドを使用して行う必要があります。

D3DCREATE_HARDWARE_VERTEXPROCESSING、D3DCREATE_MIXED_VERTEXPROCESSING、およびD3DCREATE_SOFTWARE_VERTEXPROCESSINGは相互に排他的なフラグであり、このメソッドを呼び出すときに、これらの頂点処理フラグの少なくとも 1 つを指定する必要があることに注意してください。

デバイスの一部として作成されたバックバッファーは、プレゼンテーションパラメーターでD3DPRESENTFLAG_LOCKABLE_BACKBUFFERが指定されている場合にのみロックできます。 (マルチサンプリングされたバックバッファーと深度サーフェスはロックできません。

Reset、IUnknown、および TestCooperativeLevel メソッドは、このメソッドを使用してデバイスを作成したのと同じスレッドから呼び出す必要があります。

D3DFMT_UNKNOWNは、 CreateDevice、 Reset、 CreateAdditionalSwapChain を呼び出すときに、ウィンドウモードのバックバッファー形式に指定できます。つまり、ウィンドウモードで CreateDevice を呼び出す前に、アプリケーションで現在のデスクトップ形式に対してクエリを実行する必要はありません。全画面表示モードの場合は、バックバッファー形式を指定する必要があります。

0x0 サイズのウィンドウでデバイスを作成しようとすると、 CreateDevice は失敗します。

要件


対象プラットフォーム	Windows
ヘッダー	d3d9helper.h (D3D9.h を含む)
Library	D3D9.lib

次の方法で共有

IDirect3D9::CreateDevice メソッド (d3d9helper.h)

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース