次の方法で共有

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

こちらもご覧ください

Direct3D 関数