Microsoft DirectX 8.0 (C++)

Direct3DCreate8

Direct3D8 オブジェクトのインスタンスを作成する。

IDirect3D8* Direct3DCreate8(
  UINT SDKVersion
);

パラメータ

SDKVersion
このパラメータの値は D3D_SDK_VERSION でなければならない。「注意」を参照すること。

戻り値

成功した場合は、IDirect3D8 インターフェイスへのポインタを返す。それ以外の場合は、NULL ポインタを返す。

注意

この関数は、列挙をサポートする Direct3D8 オブジェクトを作成する。また、この関数を使用して Direct3DDevice8 オブジェクトを作成できる。

アプリケーションが正しいヘッダー ファイルに対してビルドされていることを確認するため、Direct3DCreate8 には D3D_SDK_VERSION 識別子を渡す。ヘッダーまたはほかの変更によりアプリケーションのリビルドが必要になるたびに、この値はインクリメントされる。バージョンが一致しない場合、Direct3DCreate8 は失敗する。

この関数を呼び出すと、現在のアクティブ ディスプレイ アダプタ セットがサンプリングされる。デスクトップにデバイスを追加したり、ラップトップをホットドッキングして、動的にアダプタを追加した場合、この Direct3D8 オブジェクトの有効期間の間、そのようなデバイスは列挙されない。新しい Direct3D8 オブジェクトを作成すると、新しいデバイスが公開される。

動作環境

  ヘッダー : D3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。