D3DX10CreateDevice 関数
ディスプレイ アダプターを表す最適な Direct3D 10 デバイスを作成します。 Direct3D 10.1 互換デバイスを作成できる場合は、返されたデバイス インターフェイス ポインターから ID3D10Device1 インターフェイス ポインターを取得できます。
構文
HRESULT D3DX10CreateDevice(
_In_ IDXGIAdapter *pAdapter,
_In_ D3D10_DRIVER_TYPE DriverType,
_In_ HMODULE Software,
_In_ UINT Flags,
_Out_ ID3D10Device **ppDevice
);
パラメーター
-
pAdapter [in]
-
種類: IDXGIAdapter*
ハードウェア デバイスの作成時に、ディスプレイ アダプターへのポインター ( IDXGIAdapter インターフェイスを参照)。それ以外の場合は、このパラメーターを NULL に設定 します。 ハードウェア デバイスの作成時に NULL が指定されている場合、Direct3D は IDXGIFactory インターフェイスによって列挙された最初のアダプターを使用します。
-
DriverType [in]
-
デバイス ドライバーの種類 ( D3D10_DRIVER_TYPE 列挙を参照)。 ドライバーの種類によって、作成するデバイスの種類が決まります。
-
ソフトウェア [入力]
-
種類: HMODULE
ソフトウェア ドライバー (D3D10Ref.dll など) を実装する読み込まれたモジュールへのハンドル。 ハンドルを取得するには、 GetModuleHandle 関数を呼び出します。
-
Flags [in]
-
型: UINT
API レイヤーを有効にするデバイス作成フラグ (D3D10_CREATE_DEVICE_FLAG列挙を参照)。 これらのフラグは、ビットごとの OR を一緒に使用できます。
-
ppDevice [out]
-
種類: ID3D10Device**
作成されたデバイスへのポインターのアドレス ( ID3D10Device インターフェイスを参照)。
戻り値
種類: HRESULT
この関数は、次のいずれかの Direct3D 10 リターン コードを返します。
解説
この関数は、ハードウェアに最適なデバイスの作成を試みます。 まず、関数は 10.1 デバイスの作成を試みます。 10.1 デバイスを作成できない場合、関数は 10.0 デバイスの作成を試みます。 どちらのデバイスも正常に作成されていない場合、関数は E_FAILを返します。
アプリケーションで 10.1 デバイスのみを作成する必要がある場合、または 10.0 デバイスのみを作成する必要がある場合は、代わりに次の関数を使用します。
- D3D10CreateDevice 関数を使用して、Direct3D 10.0 デバイスのみを作成します。
- D3D10CreateDevice1 関数を使用して、Direct3D 10.1 デバイスのみを作成します。
- D3DX10GetFeatureLevel1 関数を使用して、ID3D10Device インターフェイス ポインターから ID3D10Device1 インターフェイス ポインターを取得します。
Direct3D 10.1 デバイスは、Windows Vista Service Pack 1 以降を実行し、Direct3D 10.1 互換ハードウェアがインストールされているコンピューターでのみ作成できます。 ただし、D3DX10 DLL がインストールされている任意のバージョンの Windows を実行しているコンピューターでこの関数を呼び出すと有効です。
要件
要件 | 値 |
---|---|
ヘッダー |
|
関連項目