Direct3DCreate9 関数 (d3d9.h)
IDirect3D9 オブジェクトを作成し、インターフェイスを返します。
構文
IDirect3D9 * Direct3DCreate9(
UINT SDKVersion
);
パラメーター
SDKVersion
型: UINT
このパラメーターの値はD3D_SDK_VERSIONする必要があります。 「解説」を参照してください。
戻り値
種類: IDirect3D9*
成功した場合、この関数は IDirect3D9 インターフェイスへのポインターを返します。それ以外の場合は、 NULL ポインターが返されます。
注釈
Direct3D オブジェクトは、グラフィカル アプリケーションが作成する必要がある最初の Direct3D COM オブジェクトと、アプリケーションが解放する必要がある最後のオブジェクトです。 デバイスの機能を列挙および取得するための関数には、Direct3D オブジェクトを使用してアクセスできます。 これにより、アプリケーションはデバイスを作成せずに選択できます。
次に示すように、IDirect3D9 オブジェクトを作成します。
LPDIRECT3D9 g_pD3D = NULL;
if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))
return E_FAIL;
IDirect3D9 インターフェイスは、アクティブなディスプレイ アダプターの列挙をサポートし、 IDirect3DDevice9 オブジェクトの作成を可能にします。 ユーザーがアダプターを動的に追加する場合 (デスクトップにデバイスを追加するか、ノート PC をホットドッキングすることによって)、それらのデバイスは列挙に含まれません。 新しい IDirect3D9 インターフェイスを作成すると、新しいデバイスが公開されます。
アプリケーションがコンパイルされるヘッダー ファイルが、コンピューターにインストールされているランタイム DLL のバージョンと一致することを確認するために、この関数にD3D_SDK_VERSIONが渡されます。 D3D_SDK_VERSIONは、ヘッダーの変更 (またはその他のコード変更) でアプリケーションを再構築する必要がある場合にのみ、ランタイムで変更されます。 この関数が失敗した場合、ヘッダー ファイルのバージョンがランタイム DLL バージョンと一致しないことを示します。
例については、「 デバイスの作成 (Direct3D 9)」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d9.h (D3D9.h を含む) |
| Library | D3d9.lib |
| [DLL] | D3d9.dll |