Platform SDK: DirectX |
D3DXCreateContext 関数は、指定されたデバイスを初期化する。
HRESULT D3DXCreateContext( DWORD deviceIndex, DWORD flags, HWND hwnd, DWORD width, DWORD height, LPD3DXCONTEXT* ppCtx );
成功すれば、S_OK を返す。
失敗すれば、次いずれかの値を返す。
アプリケーションがウィンドウ モードで動作している場合、hwnd は有効なウィンドウでなければならない (NULL または D3DX_DEFAULT は指定できない)。また、width または height のいずれかが D3DX_DEFAULT の場合、両方の値に hwnd クライアント領域のディメンジョンのデフォルト値が設定される。
アプリケーションがフルスクリーン モードで動作している場合、hwnd は有効なウィンドウでなければならない (NULL または D3DX_DEFAULT は指定できない)。また、width または height のいずれかが D3DX_DEFAULT の場合、デフォルト値として width には 640 ピクセルが、height には 480 ピクセルが設定される。
アプリケーションがオフスクリーン モードで動作している場合、hwnd は NULL または D3DX_DEFAULT でなければならない。width または height のいずれかが D3DX_DEFAULT の場合は、エラーが返される。
D3DXCreateContext 関数は、使用可能な Direct3DX 初期化関数の中で最も簡単なものである。パラメータは、D3DXCreateContextEx 関数のパラメータの照合サブセットと同じように処理される。D3DXCreateContext 関数にない D3DXCreateContextEx パラメータは、D3DX_DEFAULT として処理される。
メモ D3DXCreateContext 関数で作成されるコンテキストでは、マルチ モニタ システムがサポートされていない。マルチ モニタのサポートについては、D3DXCreateContextEx 関数を参照すること。
すべての関数について、D3DXCreateContext が障害発生時に安全であると考えてはならない。サポートされているデバイスの能力は、パラメータ値を選択するためのガイドとして使用すること。パラメータの組み合わせの中には、うまく動作しないものが必ず存在する。
D3DXCreateContext 関数によりセットアップされるデフォルト射影行列は、pi/2 ラジアンの視域 (fov) での左手座標系パースペクティブ射影である。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以上が必要。Windows 95 用に再配布可能な形で使用可能。
バージョン : DirectX 7.0 が必要。
ヘッダー : d3dxcore.h で宣言。
ライブラリ : d3dx.lib を使用。