Direct3DCreate9
IDirect3D9 オブジェクトを作成し、それに対するインターフェイスを返します。
IDirect3D9 *
Direct3DCreate9(
UINT SDKVersion
);
パラメータ
- SDKVersion
このパラメーターの値は、D3D_SDK_VERSION でなければなりません。「解説」を参照してください。
戻り値
成功した場合は IDirect3D9 インターフェイスに対するポインターが返され、失敗した場合は NULL ポインターが返されます。
解説
この Direct3D オブジェクトは、グラフィカル アプリケーションで最初に作成し、最後に解放する必要がある Direct3D COM オブジェクトです。デバイスの能力を列挙および取得するための関数には、この Direct3D オブジェクトを介してアクセスできます。これにより、アプリケーションは、デバイスを作成することなくデバイスを選択できます。
IDirect3D9 オブジェクトは、以下のように作成します。
LPDIRECT3D9 g_pD3D = NULL; if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION))) return E_FAIL;
IDirect3D9 インターフェイスは、アクティブなディスプレイ アダプターの列挙をサポートしており、IDirect3DDevice9 オブジェクトを作成できます。(デスクトップに対するデバイスの追加またはラップトップのホットドッキングにより) ユーザーがアダプターを動的に追加した場合、それらのデバイスは列挙に含まれません。新しい IDirect3D9 インターフェイスを作成すると、該当する新しいデバイスが公開されます。
D3D_SDK_VERSION をこの関数に渡すと、アプリケーションのコンパイル時に参照されるヘッダー ファイルは、マシンにインストールされているランタイム DLL のバージョンに一致します。D3D_SDK_VERSION はランタイムの際、ヘッダー (または他のコード) の変更によってアプリケーションの再ビルドが必要になる場合にのみ変更されます。この関数が失敗した場合、ヘッダー ファイルのバージョンが、ランタイム DLL のバージョンに一致していないことを示しています。
例については、「デバイスの作成 (Direct3D 9)」を参照してください。
要件
ヘッダー: D3D9.h 宣言
ライブラリ: D3D9.lib 内容