IDirect3DDevice9

IDirect3DDevice9 (d3d9.h) — アプリケーションは IDirect3DDevice9 インターフェイスのメソッドを使用して、DrawPrimitive ベースのレンダリングやリソースの作成を行います。

IDirect3DDevice9 インターフェイスは、IDirect3D9::CreateDevice メソッドを呼び出して取得します。

このインターフェイスは、すべての COM インターフェイスと同様に IUnknown インターフェイスのメソッドを継承します。

LPDIRECT3DDEVICE9 型および PDIRECT3DDEVICE9 型は、IDirect3DDevice9 インターフェイスへのポインターとして定義されています。

typedef struct IDirect3DDevice9 *LPDIRECT3DDEVICE9, *PDIRECT3DDEVICE9;

IDirect3DDevice9::TestCooperativeLevel メソッド (d3d9.h) は、ウィンドウ モードまたはフルスクリーン モードのアプリケーションについて、Direct3D デバイスの現在の協調レベル (cooperative level) の状態を報告します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK であり、デバイスが動作可能で呼び出し元のアプリケーションが処理を継続できることを示します。 メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_DEVICELOST、D3DERR_DEVICENOTRESET、D3DERR_DRIVERINTERNALERROR。

デバイスが失われており、現時点では復元できない場合、IDirect3DDevice9::TestCooperativeLevel は D3DERR_DEVICELOST を返します。たとえば、フルスクリーンのデバイスがフォーカスを失った場合がこれに該当します。アプリケーションはデバイスの喪失を検出した場合、処理を一時停止し、D3DERR_DEVICENOTRESET が返されるまで IDirect3DDevice9::TestCooperativeLevel を定期的に呼び出す必要があります。その後、IDirect3DDevice9::Reset を呼び出してデバイスのリセットを試み、成功した場合は必要なリソースを復元して通常の動作を再開できます。なお、デバイスが「lost」または「not reset」の状態にある場合、IDirect3DDevice9::Present は D3DERR_DEVICELOST を返します。

リセット対象のデバイスを作成したスレッドとは別のスレッドから呼び出した場合、IDirect3DDevice9::TestCooperativeLevel の呼び出しは失敗します。

IDirect3DDevice9::GetAvailableTextureMem メソッド (d3d9.h) は、使用可能なテクスチャ メモリ量の推定値を返します。

型: UINT

この関数は、使用可能なテクスチャ メモリの推定値を返します。

戻り値は最も近い MB 単位に丸められます。これは、アラインメントや特定のリソースによる消費に影響するその他の要因により、ビデオ メモリの推定値が厳密なものにはならないという事実を反映するためです。アプリケーションはこの値を用いて、ミップマップを何レベルまで割り当てるかといった大まかなメモリ可用性の見積もりを行うことはできますが、別のリソースを割り当てるだけのメモリが残っているかどうかといった細かい判断には使用できません。

IDirect3DDevice9::EvictManagedResources メソッド (d3d9.h) は、Direct3D 管理およびドライバー管理の両方を含む、すべての管理対象リソースを追い出します (evict)。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_OUTOFVIDEOMEMORY、D3DERR_COMMAND_UNPARSED のいずれかになります。

この関数は、リソースの D3DPOOL_DEFAULT のコピーのみを追い出します。システム メモリ上のリソースのコピーは保持されます。D3DPOOL を参照してください。

IDirect3DDevice9::GetDirect3D メソッド (d3d9.h) は、このデバイスを作成した Direct3D オブジェクトのインスタンスへのインターフェイスを返します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

IDirect3DDevice9::GetDirect3D を呼び出すと、IDirect3D9 インターフェイスの内部参照カウントが増加します。この IDirect3D9 インターフェイスの使用を終えた際に IUnknown::Release を呼び出さないと、メモリ リークが発生します。

IDirect3DDevice9::GetDeviceCaps メソッド (d3d9.h) は、レンダリング デバイスの機能 (capabilities) を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

デバイスがソフトウェア頂点処理モードで使用されている場合、IDirect3DDevice9::GetDeviceCaps はソフトウェア頂点パイプラインの機能を取得します。

IDirect3DDevice9::GetDisplayMode メソッド (d3d9.h) は、ディスプレイ モードの空間解像度、色解像度、およびリフレッシュ レートを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

IDirect3DDevice9::GetCreationParameters メソッド (d3d9.h) は、デバイスの作成パラメーターを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。

引数が無効な場合は D3DERR_INVALIDCALL が返されます。

返された D3DDEVICE_CREATION_PARAMETERS 構造体の AdapterOrdinal メンバーを参照することで、このデバイスが表すアダプターの序数を取得できます。

IDirect3DDevice9::SetCursorProperties メソッド (d3d9.h) は、カーソルのプロパティを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

次のいずれかの条件を満たす場合、オペレーティング システムのカーソルが作成され使用されます。

• ハードウェアが D3DCURSORCAPS_COLOR を設定しており (D3DCURSORCAPS を参照)、かつカーソル サイズが 32x32 (オペレーティング システムにおけるカーソル サイズ) である。
• アプリケーションがウィンドウ モードで実行されている。

アプリケーションでは、常に WM_MOUSEMOVE イベントを捕捉して DXSetCursorPosition を呼び出すことを推奨します。

Direct3D のカーソル関数は、ハードウェアに応じて GDI カーソルまたはソフトウェア エミュレーションのいずれかを使用します。通常、ユーザーは WM_SETCURSOR メッセージに応答したいと考えます。たとえば、メッセージ ハンドラーを次のように記述できます。

case WM_SETCURSOR:
// Turn off window cursor. 
SetCursor( NULL );
m_pd3dDevice->ShowCursor( TRUE );
return TRUE; // Prevent Windows from setting cursor to window class cursor.
break;

また、カーソルを変更したい場合には IDirect3DDevice9::SetCursorProperties メソッドを呼び出します。

アプリケーションは、D3DCAPS9 構造体の該当メンバーを調べることで、カーソルに関して利用可能なハードウェア サポートを判定できます。通常、ハードウェアは 32x32 のカーソルのみをサポートし、ウィンドウ モードではシステムが 32x32 のカーソルしかサポートしない場合があります。この場合でも IDirect3DDevice9::SetCursorProperties は成功しますが、カーソルはそのサイズに縮小されることがあります。ホット スポットも適切にスケーリングされます。

デバイスが失われるとカーソルは維持されません。このメソッドは、デバイスのリセット後に呼び出す必要があります。

IDirect3DDevice9::SetCursorPosition メソッド (d3d9.h) は、カーソルの位置と更新オプションを設定します。

フルスクリーン モードで実行している場合、スクリーン空間座標は現在のディスプレイ モードに合わせて適切にスケーリングされたバック バッファー座標になります。ウィンドウ モードで実行している場合、スクリーン空間座標はデスクトップ座標になります。カーソル画像は、指定された位置から SetCursorProperties メソッドで指定したホット スポット オフセットを引いた位置に描画されます。

ShowCursor によってカーソルが非表示にされている場合、カーソルは描画されません。

IDirect3DDevice9::ShowCursor メソッド (d3d9helper.h) は、カーソルを表示または非表示にします。

型: BOOL

直前までカーソルが表示されていたかどうかを示す値です。直前までカーソルが表示されていた場合は TRUE、表示されていなかった場合は FALSE です。

Direct3D のカーソル関数は、ハードウェアに応じて GDI カーソルまたはソフトウェア エミュレーションのいずれかを使用します。通常、ユーザーは WM_SETCURSOR メッセージに応答したいと考えます。たとえば、メッセージ ハンドラーを次のように記述できます。

    
case WM_SETCURSOR:

// Turn off window cursor 
    
SetCursor( NULL );
    
m_pd3dDevice->ShowCursor( TRUE );
    
return TRUE; // prevent Windows from setting cursor to window class cursor
    
break;

また、カーソルを変更したい場合には IDirect3DDevice9::SetCursorProperties メソッドを呼び出します。詳細については、DirectX Graphics の C/C++ サンプルのコードを参照してください。

IDirect3DDevice9::CreateAdditionalSwapChain メソッド (d3d9.h) は、複数のビューをレンダリングするための追加のスワップチェーンを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_NOTAVAILABLE、D3DERR_DEVICELOST、D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

Direct3D 9 ではスワップチェーンがデバイスのプロパティとして 1 つ用意されているため、各デバイスには常に少なくとも 1 つのスワップチェーン (暗黙のスワップチェーン) が存在します。

なお、どのデバイスもフルスクリーンのスワップチェーンは 1 つしかサポートできません。

IDirect3D9::CreateDevice、IDirect3DDevice9::Reset、および CreateAdditionalSwapChain の呼び出し時に、ウィンドウ モードのバック バッファー形式として D3DFMT_UNKNOWN を指定できます。つまり、ウィンドウ モードで CreateDevice を呼び出す前に、現在のデスクトップ形式を照会する必要はありません。フルスクリーン モードの場合は、バック バッファー形式を指定する必要があります。

IDirect3DDevice9::GetSwapChain メソッド (d3d9.h) は、スワップチェーンへのポインターを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::GetNumberOfSwapChains メソッド (d3d9.h) は、暗黙のスワップチェーンの数を取得します。

型: UINT

暗黙のスワップチェーンの数です。「解説」を参照してください。

暗黙のスワップチェーンは、IDirect3D9::CreateDevice の実行中にデバイスによって作成されます。このメソッドは、CreateDevice によって作成されたスワップチェーンの数を返します。

アプリケーションは、IDirect3DDevice9::CreateAdditionalSwapChain を使用して追加のスワップチェーンを作成できます。

IDirect3DDevice9::Reset メソッド (d3d9.h) は、スワップチェーンの種類、サイズ、形式をリセットします。

型: HRESULT

返される可能性のある値: D3D_OK、D3DERR_DEVICELOST、D3DERR_DEVICEREMOVED、D3DERR_DRIVERINTERNALERROR、D3DERR_OUTOFVIDEOMEMORY (D3DERR を参照)。

IDirect3DDevice9::Reset の呼び出しが失敗すると、デバイスは (IDirect3DDevice9::TestCooperativeLevel の呼び出しで D3DERR_DEVICENOTRESET が返される) 「not reset」状態にすでにある場合を除き、「lost」状態に置かれます (IDirect3DDevice9::TestCooperativeLevel の呼び出しで D3DERR_DEVICELOST が返されることで示されます)。デバイス喪失時の IDirect3DDevice9::Reset の使用方法の詳細については、IDirect3DDevice9::TestCooperativeLevel および Lost Devices (Direct3D 9) を参照してください。

IDirect3DDevice9::Reset を呼び出すと、すべてのテクスチャ メモリ サーフェスが失われ、管理対象テクスチャがビデオ メモリからフラッシュされ、すべての状態情報が失われます。デバイスに対して IDirect3DDevice9::Reset メソッドを呼び出す前に、アプリケーションはそのデバイスに関連付けられた明示的なレンダーターゲット、深度ステンシル サーフェス、追加のスワップチェーン、ステート ブロック、および D3DPOOL_DEFAULT のリソースをすべて解放する必要があります。

スワップチェーンにはフルスクリーンとウィンドウの 2 種類があります。新しいスワップチェーンがフルスクリーンの場合、アダプターは新しいサイズに一致するディスプレイ モードに設定されます。

Direct3D 9 アプリケーションでは、この呼び出しの実行中 (たとえばこの呼び出しから戻る前) にメッセージが送信されることがあります。アプリケーションはこのタイミングで Direct3D を呼び出さないよう注意する必要があります。さらに、IDirect3DDevice9::Reset が失敗した場合に呼び出せる有効なメソッドは、IDirect3DDevice9::Reset、IDirect3DDevice9::TestCooperativeLevel、および各種の Release メンバー関数のみです。それ以外のメソッドを呼び出すと例外が発生する可能性があります。

リセット対象のデバイスを作成したスレッドとは別のスレッドから呼び出した場合、IDirect3DDevice9::Reset の呼び出しは失敗します。

Direct3D 9 では、ピクセル シェーダーと頂点シェーダーは IDirect3DDevice9::Reset の呼び出し後も保持されます。アプリケーションが明示的に再作成する必要はありません。

IDirect3D9::CreateDevice、IDirect3DDevice9::Reset、および IDirect3DDevice9::CreateAdditionalSwapChain の呼び出し時に、ウィンドウ モードのバック バッファー形式として D3DFMT_UNKNOWN を指定できます。つまり、ウィンドウ モードで IDirect3D9::CreateDevice を呼び出す前に、現在のデスクトップ形式を照会する必要はありません。フルスクリーン モードの場合は、バック バッファー形式を指定する必要があります。BackBufferCount を 0 に設定する (BackBufferCount = 0) と、バック バッファーは 1 つになります。

グループ内の複数のディスプレイ アダプターをリセットする場合は、アダプター グループ内の各ディスプレイに 1 つずつ対応する D3DPRESENT_PARAMETERS 構造体の配列を指すように pPresentationParameters を設定します。

マルチヘッド デバイスが D3DCREATE_ADAPTERGROUP_DEVICE で作成された場合、IDirect3DDevice9::Reset には D3DPRESENT_PARAMETERS 構造体の配列が必要であり、各構造体はフルスクリーン ディスプレイを指定しなければなりません。ウィンドウ モードに戻すには、アプリケーションはデバイスを破棄し、ウィンドウ モードで非マルチヘッド デバイスを再作成する必要があります。

IDirect3DDevice9::Present メソッド (d3d9.h) は、デバイスが所有するバック バッファー列のうち、次のバッファーの内容を表示 (プレゼント) します。

型: HRESULT

返される可能性のある値: D3D_OK または D3DERR_DEVICEREMOVED (D3DERR を参照)。

必要に応じて、コピー元矩形内のピクセルを対象ウィンドウのクライアント領域内のコピー先矩形へ転送するために、拡大縮小 (ストレッチ) 操作が適用されます。

レンダーターゲットが現在のレンダーターゲットでない場合 (追加のスワップチェーンを作成して得られるバック バッファーなど) を除き、BeginScene と EndScene の間で Present を呼び出すと、D3DERR_INVALIDCALL を返して失敗します。これは Direct3D 9 における新しい動作です。

IDirect3DDevice9::GetBackBuffer メソッド (d3d9.h) は、デバイスのスワップチェーンからバック バッファーを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。BackBuffer がバック バッファーの総数以上の場合、この関数は失敗し D3DERR_INVALIDCALL を返します。

このメソッドを呼び出すと、IDirect3DSurface9 インターフェイスの内部参照カウントが増加します。この IDirect3DSurface9 インターフェイスの使用を終えた際に IUnknown::Release を呼び出さないと、メモリ リークが発生します。

IDirect3DDevice9::GetRasterStatus メソッド (d3d9.h) は、スワップチェーンが表示されているモニターのラスターに関する情報を返します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。pRasterStatus が無効な場合、またはデバイスが現在のスキャン ラインの読み取りをサポートしていない場合は D3DERR_INVALIDCALL が返されます。デバイスがスキャン ラインの読み取りをサポートしているかどうかを判定するには、D3DCAPS9 の Caps メンバーに D3DCAPS_READ_SCANLINE フラグがあるかを確認してください。

IDirect3DDevice9::SetDialogBoxMode メソッド (d3d9.h) は、フルスクリーン モードのアプリケーションで GDI ダイアログ ボックスを使用できるようにします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。次のすべての条件を満たさない限り、メソッドは失敗し、戻り値は D3DERR_INVALIDCALL になります。

• アプリケーションが GDI と互換性のあるバック バッファー形式、すなわち D3DFMT_X1R5G5B5、D3DFMT_R5G6B5、D3DFMT_X8R8G8B8 のいずれかを指定していること。
• アプリケーションがマルチサンプリングを指定していないこと。
• アプリケーションが D3DSWAPEFFECT_DISCARD を指定していること。
• アプリケーションが D3DPRESENTFLAG_LOCKABLE_BACKBUFFER を指定していること。
• アプリケーションが D3DCREATE_ADAPTERGROUP_DEVICE を指定していないこと。
• アプリケーションが BeginScene と EndScene の間にないこと。

GDI ダイアログ ボックスは、デバイス ウィンドウの子として作成する必要があります。また、親ウィンドウが子ウィンドウの再描画を管理できるようにするため、デバイスを作成したのと同じスレッド内で作成する必要があります。

このメソッドはウィンドウ モードのアプリケーションでは効果がありませんが、アプリケーションがデバイスをフルスクリーン モードにリセットした場合にはこの設定が適用されます。ウィンドウ モードのアプリケーションで SetDialogBoxMode が成功した場合、その後フルスクリーン モードへリセットする際に上記の制約が検査されます。また、SetDialogBoxMode を呼び出すとスワップチェーン上のすべてのバック バッファーが破棄されるため、アプリケーションはこの呼び出しの後にすべてのバック バッファーの内容を再描画する必要があります。

IDirect3DDevice9::SetGammaRamp メソッド (d3d9.h) は、暗黙のスワップチェーンに対するガンマ補正ランプを設定します。

Direct3D 9 ではスワップチェーンがデバイスのプロパティとして 1 つ用意されているため、各デバイスには常に少なくとも 1 つのスワップチェーン (暗黙のスワップチェーン) が存在します。ガンマ ランプは直ちに反映され、垂直同期を待つことはありません。

スワップチェーンの現在のプレゼンテーション モード (フルスクリーンまたはウィンドウ) でデバイスがガンマ ランプをサポートしていない場合でも、エラーは返されません。アプリケーションは D3DCAPS9 構造体の Caps2 メンバーにある D3DCAPS2_FULLSCREENGAMMA および D3DCAPS2_CANCALIBRATEGAMMA の機能ビットを確認することで、デバイスの機能とキャリブレーターがインストールされているかどうかを判定できます。

ウィンドウ モードでのガンマ補正されたプレゼンテーションには、ハードウェアがこの機能をサポートしている場合、IDirect3DSwapChain9::Present を使用してください。DirectX 8 では、SetGammaRamp はフルスクリーン モードのアプリケーションでのみガンマ ランプを設定します。ガンマ補正の詳細については、Gamma (Direct3D 9) を参照してください。

IDirect3DDevice9::GetGammaRamp メソッド (d3d9.h) は、スワップチェーンのガンマ補正ランプを取得します。

IDirect3DDevice9::CreateTexture メソッド (d3d9.h) は、テクスチャ リソースを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

アプリケーションは、D3DUSAGE_AUTOGENMIPMAP を指定して IDirect3D9::CheckDeviceFormat を呼び出すことで、特定の形式におけるミップマップの自動生成 (Direct3D 9)のサポート状況を確認できます。IDirect3D9::CheckDeviceFormat が D3DOK_NOAUTOGEN を返す場合、IDirect3DDevice9::CreateTexture は成功しますが、レベルが 1 つだけのテクスチャを返します。

Windows Vista では、CreateTexture はシステム メモリ ポインターからテクスチャを作成でき、システム メモリの使用、割り当て、削除についてアプリケーションにより高い柔軟性をもたらします。たとえば、GDI のシステム メモリ ビットマップのポインターを渡し、それをラップする Direct3D テクスチャ インターフェイスを得ることができます。CreateTexture でシステム メモリ ポインターを使用する場合、次の制約があります。

• テクスチャのピッチは、幅にピクセルあたりのバイト数を掛けた値と等しくなければなりません。
• ミップマップ レベルが 1 つのテクスチャのみがサポートされます。Levels 引数は 1 でなければなりません。
• Pool 引数は D3DPOOL_SYSTEMMEM でなければなりません。
• pSharedHandle 引数は、システム メモリ ポインターを保持できるバッファーへの有効なポインターでなければなりません。*pSharedHandle は、テクスチャの幅 * テクスチャの高さ * テクスチャ形式のピクセルあたりのバイト数、というバイト サイズを持つシステム メモリへの有効なポインターでなければなりません。

IDirect3DDevice9::CreateVolumeTexture メソッド (d3d9.h) は、ボリューム テクスチャ リソースを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

IDirect3DDevice9::CreateCubeTexture メソッド (d3d9.h) は、キューブ テクスチャ リソースを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

ミップマップ (テクスチャ) は、順次ダウンサンプリングされた (ミップマップ化された) サーフェスの集合です。一方、キューブ テクスチャ (IDirect3DDevice9::CreateCubeTexture によって作成) は、各面に 1 つずつ対応する 6 つのテクスチャ (ミップマップ) の集合です。キューブ テクスチャにはすべての面が存在しなければなりません。また、キューブ マップ サーフェスは 3 つの次元 (x、y、z) すべてで同じピクセル サイズでなければなりません。

アプリケーションは、D3DUSAGE_AUTOGENMIPMAP を指定して IDirect3D9::CheckDeviceFormat を呼び出すことで、特定の形式におけるミップマップの自動生成 (Direct3D 9)のサポート状況を確認できます。IDirect3D9::CheckDeviceFormat が D3DOK_NOAUTOGEN を返す場合、IDirect3DDevice9::CreateCubeTexture は成功しますが、レベルが 1 つだけのテクスチャを返します。

IDirect3DDevice9::CreateVertexBuffer メソッド (d3d9.h) は、頂点バッファーを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

頂点バッファーは、ハードウェア頂点処理とソフトウェア頂点処理のいずれでも使用できます。どちらになるかは、デバイスと頂点バッファーの作成方法によって決まります。

デバイスの作成時、CreateDevice は動作フラグを用いて頂点をハードウェアで処理するかソフトウェアで処理するかを決定します。次の 3 つの選択肢があります。

• D3DCREATE_HARDWARE_VERTEXPROCESSING を設定して、頂点をハードウェアで処理する。
• D3DCREATE_SOFTWARE_VERTEXPROCESSING を設定して、頂点をソフトウェアで処理する。
• D3DCREATE_MIXED_VERTEXPROCESSING を設定して、頂点をハードウェアまたはソフトウェアのいずれかで処理する。

頂点バッファーの作成時、CreateVertexBuffer は usage パラメーターを用いて頂点をハードウェアで処理するかソフトウェアで処理するかを決定します。

• CreateDevice が D3DCREATE_HARDWARE_VERTEXPROCESSING を使用する場合、CreateVertexBuffer は 0 を使用しなければなりません。
• CreateDevice が D3DCREATE_SOFTWARE_VERTEXPROCESSING を使用する場合、CreateVertexBuffer は 0 または D3DUSAGE_SOFTWAREPROCESSING のいずれかを使用しなければなりません。いずれの値の場合も、頂点はソフトウェアで処理されます。
• CreateDevice が D3DCREATE_MIXED_VERTEXPROCESSING を使用する場合、CreateVertexBuffer は 0 または D3DUSAGE_SOFTWAREPROCESSING のいずれも使用できます。

IDirect3DDevice9 インターフェイスは、頂点バッファー オブジェクトに格納された頂点データを使用したプリミティブのレンダリングをサポートします。頂点バッファーは IDirect3DDevice9 から作成され、それを作成した IDirect3DDevice9 オブジェクトでのみ使用できます。

FVF パラメーターに 0 以外の値 (有効な FVF コードでなければなりません) を設定すると、バッファーの内容が FVF コードによって特徴付けられることを示します。FVF コードを指定して作成された頂点バッファーは、FVF 頂点バッファーと呼ばれます。詳細については、FVF Vertex Buffers (Direct3D 9) を参照してください。

非 FVF バッファーは、マルチパス レンダリングや、単一パスでのマルチテクスチャ レンダリングの際にデータをインターリーブするために使用できます。この場合、1 つのバッファーにジオメトリ データを格納し、他のバッファーにレンダリング対象の各テクスチャのテクスチャ座標を格納します。レンダリング時には、ジオメトリ データを含むバッファーが、テクスチャ座標を含む各バッファーとインターリーブされます。代わりに FVF バッファーを使用した場合、各バッファーにはレンダリングされるテクスチャごとのテクスチャ座標データに加えて、同一のジオメトリ データを含める必要が生じます。これは、採用する方式に応じて速度またはメモリのいずれかの面で不利になります。テクスチャ座標の詳細については、Texture Coordinates (Direct3D 9) を参照してください。

IDirect3DDevice9::CreateIndexBuffer メソッド (d3d9.h) は、インデックス バッファーを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、D3DXERR_INVALIDDATA、E_OUTOFMEMORY。

インデックス バッファーは、インデックスを保持するために使用されるメモリ リソースであり、サーフェスと頂点バッファーの両方に似た性質を持ちます。インデックス バッファーを使用することで、Direct3D は不要なデータ コピーを回避し、想定される用途に最適なメモリ種別へバッファーを配置できます。

インデックス バッファーを使用するには、インデックス バッファーを作成し、ロックしてインデックスを書き込み、アンロックしたうえで IDirect3DDevice9::SetIndices に渡し、頂点と頂点シェーダーを設定してから、レンダリングのために IDirect3DDevice9::DrawIndexedPrimitive を呼び出します。

D3DCAPS9 構造体の MaxVertexIndex メンバーは、レンダリングに使用できるインデックス バッファーの種類を示します。

IDirect3DDevice9::CreateRenderTarget メソッド (d3d9.h) は、レンダーターゲット サーフェスを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_NOTAVAILABLE、D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

レンダーターゲット サーフェスは D3DPOOL_DEFAULT メモリ クラスに配置されます。

ロック可能でマルチサンプリングされたレンダーターゲットの作成はサポートされていません。

IDirect3DDevice9::CreateDepthStencilSurface メソッド (d3d9.h) は、深度ステンシル リソースを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_NOTAVAILABLE、D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

深度ステンシル バッファーのメモリ クラスは常に D3DPOOL_DEFAULT です。

IDirect3DDevice9::UpdateSurface メソッド (d3d9.h) は、あるサーフェスから別のサーフェスへ、矩形状のピクセルの部分領域をコピーします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL。

このメソッドは、DirectX 8 の CopyRects に相当します。

この関数には次の制約があります。

• コピー元サーフェスは D3DPOOL_SYSTEMMEM で作成されている必要があります。
• コピー先サーフェスは D3DPOOL_DEFAULT で作成されている必要があります。
• いずれのサーフェスもロックされていたり、未解放のデバイス コンテキストを保持していたりしてはいけません。
• いずれのサーフェスもマルチサンプリングを指定して作成されていてはいけません。両サーフェスで有効なフラグは D3DMULTISAMPLE_NONE のみです。
• サーフェス形式に深度ステンシル形式を使用することはできません。
• コピー元およびコピー先の矩形は、サーフェス内に収まっていなければなりません。
• 拡大や縮小は許可されません (両矩形は同じサイズでなければなりません)。
• コピー元の形式はコピー先の形式と一致していなければなりません。

• ドライバーが要求されたコピーをサポートしていない場合、ロックとコピーによってエミュレートされます。

アプリケーションが D3DPOOL_DEFAULT のレンダーターゲットから D3DPOOL_SYSTEMMEM のサーフェスへデータをコピーする必要がある場合は、GetRenderTargetData を使用できます。

IDirect3DDevice9::UpdateTexture メソッド (d3d9.h) は、テクスチャのダーティ (更新済み) 領域を更新します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

テクスチャの一部をダーティ状態にするには、テクスチャをロックするか、次のいずれかのメソッドを呼び出します。

• IDirect3DCubeTexture9::AddDirtyRect
• IDirect3DTexture9::AddDirtyRect
• IDirect3DVolumeTexture9::AddDirtyBox
• IDirect3DDevice9::UpdateSurface

パフォーマンス上の理由から、ダーティ領域はテクスチャのレベル 0 に対してのみ記録されます。サブレベルについては、対応する (スケーリングされた) 矩形またはボックスも同様にダーティであると見なされます。ダーティ領域は、D3DLOCK_NO_DIRTY_UPDATE や D3DLOCK_READONLY を指定せずに LockRect または IDirect3DVolumeTexture9::LockBox を呼び出した際に自動的に記録されます。また、IDirect3DDevice9::UpdateSurface のコピー先サーフェスもダーティとしてマークされます。

テクスチャの種類が異なる場合、最下位レベルのバッファーのサイズが異なる場合、または対応するレベルが一致しない場合、このメソッドは失敗します。たとえば、次の寸法を持つ 6 レベルのコピー元テクスチャを考えます。

32x16, 16x8, 8x4, 4x2, 2x1, 1x1

この 6 レベルのコピー元テクスチャは、次の 1 レベルのコピー先に対するコピー元になり得ます。

1x1

また、次の 2 レベルのコピー先に対しても同様です。

2x1, 1x1

さらに、次の 3 レベルのコピー先に対しても同様です。

4x2, 2x1, 1x1

さらに、テクスチャの形式が異なる場合もこのメソッドは失敗します。コピー先テクスチャのレベル数がコピー元より少ない場合は、対応するレベルのみがコピーされます。コピー元テクスチャのレベル数がコピー先より少ない場合、このメソッドは失敗します。

コピー元テクスチャにダーティ領域がある場合、その領域のみにコピーを限定することで処理を最適化できます。ただし、ダーティとマークされたバイトのみがコピーされることは保証されません。

コピー元とコピー先のサーフェスの組み合わせには、次の可能性があります。

• pSourceTexture が自動生成でないミップマップで、pDestinationTexture が自動生成ミップマップの場合、対応する最上位レベルのみが更新され、コピー先のサブレベルは再生成されます。コピー元のその他のサブレベルはすべて無視されます。
• pSourceTexture と pDestinationTexture の両方が自動生成ミップマップの場合、対応する最上位レベルのみが更新されます。コピー元のサブレベルは無視され、コピー先のサブレベルは再生成されます。
• pSourceTexture が自動生成ミップマップで、pDestinationTexture が自動生成でないミップマップの場合、UpdateTexture は失敗します。

IDirect3DDevice9::GetRenderTargetData メソッド (d3d9.h) は、レンダーターゲットのデータをデバイス メモリからシステム メモリへコピーします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_DRIVERINTERNALERROR、D3DERR_DEVICELOST、D3DERR_INVALIDCALL。

コピー先サーフェスは、オフスクリーン プレーン サーフェスであるか、D3DPOOL_SYSTEMMEM で作成されたテクスチャ (ミップマップまたはキューブ テクスチャ) のレベルでなければなりません。

コピー元サーフェスは、通常のレンダーターゲットであるか、POOL_DEFAULT で作成されたレンダーターゲット テクスチャ (ミップマップまたはキューブ テクスチャ) のレベルでなければなりません。

次の場合、このメソッドは失敗します。

• レンダーターゲットがマルチサンプリングされている。
• コピー元のレンダーターゲットとコピー先のサーフェスのサイズが異なる。
• コピー元のレンダーターゲットとコピー先のサーフェスの形式が一致しない。

IDirect3DDevice9::GetFrontBufferData メソッド (d3d9.h) は、デバイスのフロント バッファーを、アプリケーションが用意したシステム メモリ バッファーへコピーします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_DRIVERINTERNALERROR、D3DERR_DEVICELOST、D3DERR_INVALIDCALL

pDestSurface が指すバッファーには、標準的な 32 ビット/ピクセル形式である D3DFMT_A8R8G8B8 に変換されたフロント バッファーの内容が格納されます。

アンチエイリアシングされたスクリーン ショットを取得する方法は、このメソッドのみです。

この関数は設計上非常に低速であり、パフォーマンスが重要な処理経路では使用すべきではありません。

詳細については、Lost Devices and Retrieved Data を参照してください。

IDirect3DDevice9::StretchRect メソッド (d3d9helper.h) は、コピー元矩形の内容をコピー先矩形へコピーします。コピーの際に、コピー元を拡大縮小したりフィルタリングしたりできます。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

StretchRect の制約

• ドライバーによってサポート状況が異なります。どのドライバーがどのコピー元/コピー先の形式をサポートするかについては、後述の「ドライバーのサポート」の節を参照してください。
• コピー元およびコピー先のサーフェスは、デフォルトのメモリ プールに作成されている必要があります。
• フィルタリングを指定する場合は、適切なフィルター機能を設定する必要があります (D3DCAPS9 の StretchRectFilterCaps を参照)。
• 同一サーフェス上のコピー元矩形とコピー先矩形の間での拡大縮小はサポートされません。
• コピー先サーフェスがオフスクリーン プレーン サーフェスで、コピー元がそうでない場合、拡大縮小はサポートされません。
• いずれかのサーフェスが圧縮形式の場合、コピー元矩形とコピー先矩形の間で拡大縮小を行うことはできません (Using Compressed Textures (Direct3D 9) を参照)。
• 拡大縮小がサポートする色空間変換は、YUV から高精度 RGBA への変換のみです。色変換はソフトウェア エミュレーションではサポートされないため、IDirect3D9::CheckDeviceFormatConversion を使用してハードウェアの色変換サポートを確認してください。
• コピー元またはコピー先のサーフェスがテクスチャ サーフェス (またはキューブ テクスチャ サーフェス) の場合、D3DDEVCAPS2_CAN_STRETCHRECT_FROM_TEXTURES をサポートする Direct3D 9 ドライバーを使用する必要があります (D3DDEVCAPS2 を参照)。

• コピー元およびコピー先のサーフェスは、プレーンな深度ステンシル サーフェス (テクスチャではない) でなければなりません (IDirect3DDevice9::CreateDepthStencilSurface を参照)。
• いずれのサーフェスも破棄可能 (discardable) であってはなりません。
• サーフェス全体をコピーする必要があります (すなわち、部分矩形のコピーは許可されません)。
• 形式変換、拡大、縮小はサポートされません。
• StretchRect を BeginScene と EndScene の間で呼び出すことはできません。

StretchRect を使用して、あるレンダーターゲットから別のレンダーターゲットへコピーできます。コピー元のレンダーターゲットがマルチサンプリングされている場合、結果としてコピー元レンダーターゲットがダウンサンプリングされます。たとえば、次のようにします。

• マルチサンプリングされたレンダーターゲットを作成する。
• 同じサイズで、マルチサンプリングされていない 2 つ目のレンダーターゲットを作成する。
• (StretchRect を使用して) マルチサンプル レンダーターゲットを 2 つ目のレンダーターゲットへコピーする。

ドライバーのサポート

StretchRect で有効となるサーフェスの組み合わせには多くの制約があります。ドライバーが Direct3D 9 ドライバーかそれ以前のものか、また操作が拡大縮小を伴うかどうかといった要因が関係します。アプリケーションがドライバーの世代を認識することは想定されていないため、ランタイムは Direct3D 9 レベル以降のドライバーに対して、新しい機能ビット D3DDEVCAPS2_CAN_STRETCHRECT_FROM_TEXTURES (D3DDEVCAPS2 を参照) を自動的に設定します。

IDirect3DDevice9::ColorFill メソッド (d3d9.h) は、D3DPOOL_DEFAULT のサーフェスの矩形領域を指定した色で塗りつぶすことをアプリケーションに許可します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

このメソッドは、レンダーターゲット、レンダーターゲット テクスチャ サーフェス、またはプール タイプが D3DPOOL_DEFAULT のオフスクリーン プレーン サーフェスに対してのみ適用できます。

IDirect3DDevice9::ColorFill はすべての形式で動作します。ただし、リファレンス デバイスまたはソフトウェア デバイスを使用する場合、サポートされる形式は D3DFMT_X1R5G5B5、D3DFMT_A1R5G5B5、D3DFMT_R5G6B5、D3DFMT_X8R8G8B8、D3DFMT_A8R8G8B8、D3DFMT_YUY2、D3DFMT_G8R8_G8B8、D3DFMT_UYVY、D3DFMT_R8G8_B8G8、D3DFMT_R16F、D3DFMT_G16R16F、D3DFMT_A16B16G16R16F、D3DFMT_R32F、D3DFMT_G32R32F、および D3DFMT_A32B32G32R32F のみです。

DirectX 7 または DirectX 8.x のドライバーを使用する場合、サポートされる YUV 形式は D3DFMT_UYVY と D3DFMT_YUY2 のみです。

IDirect3DDevice9::CreateOffscreenPlainSurface メソッド (d3d9.h) は、オフスクリーン サーフェスを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

D3DPOOL_SCRATCH を指定すると、DirectX 8.x のメソッド CreateImageSurface で作成されるサーフェスと同一の特性を持つサーフェスが返されます。

IDirect3DDevice9::StretchRect および IDirect3DDevice9::ColorFill で使用する場合に適切なプールは D3DPOOL_DEFAULT です。

オフスクリーン プレーン サーフェスの作成時に D3DPOOL_MANAGED を指定することはできません。メモリ プールの詳細については、D3DPOOL を参照してください。

オフスクリーン プレーン サーフェスは、プール タイプにかかわらず常にロック可能です。

IDirect3DDevice9::SetRenderTarget メソッド (d3d9helper.h) は、デバイスに新しいカラー バッファーを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。 次のいずれかの場合、このメソッドは D3DERR_INVALIDCALL を返します。

• pRenderTarget = NULL かつ RenderTargetIndex = 0 の場合
• pRenderTarget が NULL 以外で、レンダーターゲットが無効な場合

デバイスは複数のレンダーターゲットをサポートできます。デバイスがサポートするレンダーターゲットの数は、D3DCAPS9 の NumSimultaneousRTs メンバーに格納されています。Multiple Render Targets (Direct3D 9) を参照してください。

新しいレンダーターゲットを設定すると、ビューポート (Viewports and Clipping (Direct3D 9) を参照) は新しいレンダーターゲットの全体サイズに設定されます。

一部のハードウェアは、深度ステンシル バッファーとカラー バッファーの互換性を検査します。この検査が行われる場合でも、デバッグ ビルドでのみ実施されます。

このメソッドの使用には次の制約があります。

• マルチサンプル タイプは、レンダーターゲットと深度ステンシル サーフェスで同一でなければなりません。
• 形式は、レンダーターゲットと深度ステンシル サーフェスとで互換性がなければなりません。IDirect3D9::CheckDepthStencilMatch を参照してください。
• 深度ステンシル サーフェスのサイズは、レンダーターゲットのサイズ以上でなければなりません。

キューブ テクスチャは、サーフェスの集合であるという点で他のサーフェスとは異なります。キューブ テクスチャを指定して IDirect3DDevice9::SetRenderTarget を呼び出すには、IDirect3DCubeTexture9::GetCubeMapSurface を使用して個々の面を選択し、得られたサーフェスを IDirect3DDevice9::SetRenderTarget に渡す必要があります。

IDirect3DDevice9::GetRenderTarget メソッド (d3d9.h) は、レンダーターゲット サーフェスを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、引数のいずれかが無効であれば D3DERR_INVALIDCALL、指定されたインデックスに利用可能なレンダーターゲットが存在しなければ D3DERR_NOTFOUND が返されます。

通常、状態を返すメソッドは D3DCREATE_PUREDEVICE を指定して作成されたデバイスでは動作しません。ただし、このメソッドはインターフェイスを返すため、ピュア デバイスでも動作します。

デバイスは複数のレンダーターゲットをサポートできるようになりました。デバイスがサポートするレンダーターゲットの数は、D3DCAPS9 の NumSimultaneousRTs メンバーに格納されています。Multiple Render Targets (Direct3D 9) を参照してください。

このメソッドを呼び出すと、IDirect3DSurface9 インターフェイスの内部参照カウントが増加します。この IDirect3DSurface9 インターフェイスの使用を終えた際に IUnknown::Release を呼び出さないと、メモリ リークが発生します。

IDirect3DDevice9::SetDepthStencilSurface メソッド (d3d9.h) は、深度ステンシル サーフェスを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。 pZStencilSurface が NULL 以外の場合、ステンシル サーフェスが無効であれば戻り値は D3DERR_INVALIDCALL になります。

このメソッドの使用には次の制約があります。

• マルチサンプル タイプは、レンダーターゲットと深度ステンシル サーフェスで同一でなければなりません。
• 形式は、レンダーターゲットと深度ステンシル サーフェスとで互換性がなければなりません。IDirect3D9::CheckDepthStencilMatch を参照してください。
• 深度ステンシル サーフェスのサイズは、レンダーターゲットのサイズ以上でなければなりません。

キューブ テクスチャは、サーフェスの集合であるという点で他のサーフェスとは異なります。キューブ テクスチャを指定して IDirect3DDevice9::SetDepthStencilSurface を呼び出すには、IDirect3DCubeTexture9::GetCubeMapSurface を使用して個々の面を選択し、得られたサーフェスを IDirect3DDevice9::SetDepthStencilSurface に渡す必要があります。

IDirect3DDevice9::GetDepthStencilSurface メソッド (d3d9.h) は、Direct3DDevice オブジェクトが所有する深度ステンシル サーフェスを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。デバイスに深度ステンシル バッファーが関連付けられていない場合、戻り値は D3DERR_NOTFOUND になります。それ以外でメソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

このメソッドを呼び出すと、IDirect3DSurface9 インターフェイスの内部参照カウントが増加します。この IDirect3DSurface9 インターフェイスの使用を終えた際に IUnknown::Release を呼び出さないと、メモリ リークが発生します。

IDirect3DDevice9::BeginScene メソッド (d3d9.h) は、シーンを開始します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。すでに IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene の対の内側にある状態で IDirect3DDevice9::BeginScene を呼び出した場合、このメソッドは D3DERR_INVALIDCALL で失敗します。これは、IDirect3DDevice9::EndScene を先に呼び出さずに IDirect3DDevice9::BeginScene を 2 回呼び出した場合にのみ発生します。

アプリケーションは、レンダリングを行う前に必ず IDirect3DDevice9::BeginScene を呼び出し、レンダリングが完了した時点かつ再び IDirect3DDevice9::BeginScene を呼び出す前に、必ず IDirect3DDevice9::EndScene を呼び出さなければなりません。

IDirect3DDevice9::BeginScene が失敗した場合、デバイスはシーンを開始できなかったのであり、IDirect3DDevice9::EndScene を呼び出す必要はありません。実際、直前の IDirect3DDevice9::BeginScene が失敗している場合、IDirect3DDevice9::EndScene の呼び出しも失敗します。これは、複数のスワップチェーンを作成するあらゆるアプリケーションに当てはまります。

連続する present の呼び出し (IDirect3DDevice9::Present または IDirect3DSwapChain9::Present) の間には、IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene の対が 1 つだけ存在するようにしてください。IDirect3DDevice9::BeginScene はレンダリングを行う前に 1 回呼び出し、IDirect3DDevice9::EndScene は 1 フレーム分のすべてのレンダリングをランタイムへ送信した後に 1 回呼び出します。present の呼び出しの間に入れ子でない IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene の対が複数存在することは許容されますが、対が 2 つ以上あるとパフォーマンスが低下する可能性があります。 CPU とグラフィックス アクセラレーターの並列性を最大化するには、present の呼び出しよりできるだけ早い段階で IDirect3DDevice9::EndScene を呼び出すことが有利です。

IDirect3DDevice9::EndScene メソッド (d3d9.h) は、IDirect3DDevice9::BeginScene の呼び出しによって開始されたシーンを終了します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。すでに IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene の対の内側にある状態で IDirect3DDevice9::BeginScene を呼び出した場合、このメソッドは D3DERR_INVALIDCALL で失敗します。これは、IDirect3DDevice9::EndScene を先に呼び出さずに IDirect3DDevice9::BeginScene を 2 回呼び出した場合にのみ発生します。

このメソッドが成功すると、シーンはドライバーによるレンダリングのためにキューへ登録されます。これは同期メソッドではないため、このメソッドから戻った時点でシーンのレンダリングが完了していることは保証されません。

アプリケーションは、レンダリングを行う前に必ず IDirect3DDevice9::BeginScene を呼び出し、レンダリングが完了した時点かつ再び IDirect3DDevice9::BeginScene を呼び出す前に、必ず IDirect3DDevice9::EndScene を呼び出さなければなりません。

IDirect3DDevice9::BeginScene が失敗した場合、デバイスはシーンを開始できなかったのであり、IDirect3DDevice9::EndScene を呼び出す必要はありません。実際、直前の IDirect3DDevice9::BeginScene が失敗している場合、

IDirect3DDevice9::EndScene の呼び出しも失敗します。これは、複数のスワップチェーンを作成するあらゆるアプリケーションに当てはまります。

連続する present の呼び出し (IDirect3DDevice9::Present または IDirect3DSwapChain9::Present) の間には、IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene の対は多くとも 1 つだけ存在するようにしてください。IDirect3DDevice9::BeginScene はレンダリングを行う前に 1 回呼び出し、IDirect3DDevice9::EndScene は 1 フレーム分のすべてのレンダリングをランタイムへ送信した後に 1 回呼び出します。CPU とグラフィックス アクセラレーターの並列性を最大化するには、present の呼び出しよりできるだけ早い段階で IDirect3DDevice9::EndScene を呼び出すことが有利です。

IDirect3DDevice9::Clear メソッド (d3d9.h) は、レンダーターゲット、複数のレンダーターゲット、ステンシル バッファー、深度バッファーなど、1 つ以上のサーフェスをクリアします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

このメソッドは、レンダーターゲット、MRT 内のすべてのレンダーターゲット、ステンシル バッファー、深度バッファーなどのサーフェスをクリアするために使用します。クリアされるサーフェスの数は Flags によって決まります。矩形の配列で定義されるサーフェスの一部分をクリアするには、pRects を使用します。

次の場合、IDirect3DDevice9::Clear は失敗します。

• 深度バッファーが接続されていないレンダーターゲットに対して、深度バッファーまたはステンシル バッファーをクリアしようとした場合。
• 深度バッファーがステンシル データを含んでいない状態で、ステンシル バッファーをクリアしようとした場合。

IDirect3DDevice9::SetTransform メソッド (d3d9helper.h) は、デバイスの変換に関する単一の状態を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。引数のいずれかが無効な場合は D3DERR_INVALIDCALL が返されます。

IDirect3DDevice9::GetTransform メソッド (d3d9.h) は、変換状態を記述する行列を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。引数のいずれかが無効な場合は D3DERR_INVALIDCALL となります。

このメソッドは、D3DCREATE_PUREDEVICE を指定して作成されたデバイスではデバイス状態を返しません。このメソッドを使用したい場合は、D3DCREATE の他のフラグ値のいずれかを指定してデバイスを作成する必要があります。

IDirect3DDevice9::MultiplyTransform メソッド (d3d9.h) は、デバイスのワールド行列、ビュー行列、または射影行列に、指定した行列を乗算します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。引数のいずれかが無効な場合は D3DERR_INVALIDCALL となります。

乗算の順序は pMatrix × State です。

アプリケーションは、IDirect3DDevice9::MultiplyTransform メソッドを使用して変換の階層を扱うことができます。たとえば、腕を記述するジオメトリと変換は、次のような階層で構成できます。

    
    shoulder_transformation
    
    upper_arm geometry
    
    elbow transformation
    
    lower_arm geometry
    
    wrist transformation
    
    hand geometry

アプリケーションは、次の一連の呼び出しを用いてこの階層をレンダリングできます。この疑似コードでは、すべてのパラメーターを示しているわけではありません。

IDirect3DDevice9::SetTransform(D3DTS_WORLDMATRIX(0), 
                               shoulder_transform)
IDirect3DDevice9::DrawPrimitive(upper_arm)
IDirect3DDevice9::MultiplyTransform(D3DTS_WORLDMATRIX(0), 
                                    elbow_transform)
IDirect3DDevice9::DrawPrimitive(lower_arm)
IDirect3DDevice9::MultiplyTransform(D3DTS_WORLDMATRIX(0), 
                                    wrist_transform)
IDirect3DDevice9::DrawPrimitive(hand)

IDirect3DDevice9::SetViewport メソッド (d3d9helper.h) は、デバイスのビューポート パラメーターを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合は D3DERR_INVALIDCALL を返します。これは、pViewport が無効な場合、または pViewport がレンダーターゲット サーフェス内に存在し得ない領域を記述している場合に発生します。

Direct3D はビューポートに次の既定値を設定します。

D3DVIEWPORT9 vp;
vp.X      = 0;
vp.Y      = 0;
vp.Width  = RenderTarget.Width;
vp.Height = RenderTarget.Height;
vp.MinZ   = 0.0f;
vp.MaxZ   = 1.0f;

IDirect3DDevice9::SetViewport は、画面の一部分に描画するために使用できます。ビューポートの設定を有効にするため、ジオメトリを描画する前に必ず呼び出してください。

シーン内に複数のビューを描画するには、ビューごとに IDirect3DDevice9::SetViewport の呼び出しとジオメトリの描画を繰り返します。

IDirect3DDevice9::GetViewport メソッド (d3d9.h) は、デバイスに現在設定されているビューポート パラメーターを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。pViewport パラメーターが無効な場合は D3DERR_INVALIDCALL が返されます。

通常、状態を返すメソッドは D3DCREATE_PUREDEVICE を指定して作成されたデバイスでは動作しません。ただし、このメソッドはピュア デバイスでも動作します。

IDirect3DDevice9::SetMaterial メソッド (d3d9.h) は、デバイスのマテリアル プロパティを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。pMaterial パラメーターが無効な場合は D3DERR_INVALIDCALL となります。

IDirect3DDevice9::GetMaterial メソッド (d3d9.h) は、デバイスの現在のマテリアル プロパティを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。pMaterial パラメーターが無効な場合は D3DERR_INVALIDCALL となります。

このメソッドは、D3DCREATE_PUREDEVICE を指定して作成されたデバイスではデバイス状態を返しません。このメソッドを使用したい場合は、D3DCREATE の他の値のいずれかを指定してデバイスを作成する必要があります。

IDirect3DDevice9::SetLight メソッド (d3d9.h) は、このデバイスに一組のライティング プロパティを割り当てます。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

ライトのプロパティを設定するには、D3DLIGHT9 構造体を用意し、IDirect3DDevice9::SetLight メソッドを呼び出します。

IDirect3DDevice9::SetLight メソッドは、デバイスが内部のライト プロパティ一覧のどのインデックスにそのプロパティ セットを配置するかを示すインデックスと、それらのプロパティを定義する、用意済みの D3DLIGHT9 構造体のアドレスを受け取ります。ライトの照明プロパティを更新するには、必要に応じて新しい情報を指定して IDirect3DDevice9::SetLight を呼び出します。

プロパティが一度も割り当てられていないインデックスを指定して IDirect3DDevice9::SetLight メソッドを呼び出すたびに、システムは一組のライティング プロパティを保持するためのメモリを割り当てます。アプリケーションは多数のライトを設定でき、割り当てたライトのうち一部だけを同時に有効にすることができます。デバイスの機能を取得する際に D3DCAPS9 構造体の MaxActiveLights メンバーを確認すると、そのデバイスがサポートするアクティブなライトの最大数を判定できます。不要になったライトは、無効にするか、新しいライト プロパティ セットで上書きできます。

次の例では、距離によって減衰しない光を放つ白色のポイント ライトのプロパティを用意し、設定します。

// Assume d3dDevice is a valid pointer to an IDirect3DDevice9 interface.
D3DLIGHT9 d3dLight;
HRESULT   hr;
    
// Initialize the structure.
ZeroMemory(&d3dLight, sizeof(d3dLight));
    
// Set up a white point light.
d3dLight.Type = D3DLIGHT_POINT;
d3dLight.Diffuse.r  = 1.0f;
d3dLight.Diffuse.g  = 1.0f;
d3dLight.Diffuse.b  = 1.0f;
d3dLight.Ambient.r  = 1.0f;
d3dLight.Ambient.g  = 1.0f;
d3dLight.Ambient.b  = 1.0f;
d3dLight.Specular.r = 1.0f;
d3dLight.Specular.g = 1.0f;
d3dLight.Specular.b = 1.0f;
    
// Position it high in the scene and behind the user.
// Remember, these coordinates are in world space, so
// the user could be anywhere in world space, too. 
// For the purposes of this example, assume the user
// is at the origin of world space.
d3dLight.Position.x = 0.0f;
d3dLight.Position.y = 1000.0f;
d3dLight.Position.z = -100.0f;
    
// Don't attenuate.
d3dLight.Attenuation0 = 1.0f; 
d3dLight.Range        = 1000.0f;
    
// Set the property information for the first light.
hr = d3dDevice->SetLight(0, &d3dLight);
if (SUCCEEDED(hr))
    // Handle Success
else
    // Handle failure

光源を有効にするには、デバイスに対して IDirect3DDevice9::LightEnable メソッドを呼び出します。

IDirect3DDevice9::GetLight メソッド (d3d9.h) は、このデバイスが使用する一組のライティング プロパティを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

このメソッドは、D3DCREATE_PUREDEVICE を指定して作成されたデバイスではデバイス状態を返しません。このメソッドを使用したい場合は、D3DCREATE の他の値のいずれかを指定してデバイスを作成する必要があります。

既存の光源のすべてのプロパティを取得するには、デバイスに対して IDirect3DDevice9::GetLight メソッドを呼び出します。IDirect3DDevice9::GetLight メソッドの呼び出し時には、プロパティを取得する光源の 0 から始まるインデックスを第 1 パラメーターとして渡し、D3DLIGHT9 構造体のアドレスを第 2 パラメーターとして指定します。デバイスは、そのインデックスの光源に使用しているライティング プロパティを記述するように D3DLIGHT9 構造体を埋めます。

// Assume d3dDevice is a valid pointer to an IDirect3DDevice9 interface.
HRESULT hr;
D3DLight9 light;
    
// Get the property information for the first light.
hr = pd3dDevice->GetLight(0, &light);
if (SUCCEEDED(hr))
    // Handle Success
else
    // Handle failure

デバイスに割り当てられている光源の範囲外のインデックスを指定した場合、IDirect3DDevice9::GetLight メソッドは失敗し、D3DERR_INVALIDCALL を返します。

シーン内の光源に一組のライト プロパティを割り当てた後、デバイスに対して IDirect3DDevice9::LightEnable メソッドを呼び出すことで、その光源を有効化できます。新しい光源は既定で無効です。IDirect3DDevice9::LightEnable メソッドは 2 つのパラメーターを受け取ります。第 1 パラメーターにはこのメソッドの対象となる光源の 0 から始まるインデックスを設定し、第 2 パラメーターにはライトを有効にする場合は TRUE、無効にする場合は FALSE を設定します。次のコード例は、デバイスの光源プロパティ一覧の最初の光源を有効にすることで、このメソッドの使い方を示しています。

// Assume d3dDevice is a valid pointer to an IDirect3DDevice9 interface.
HRESULT hr;
    
hr = pd3dDevice->LightEnable(0, TRUE);
if (SUCCEEDED(hr))
    // Handle Success
else
    // Handle failure

デバイスの機能を取得する際に D3DCAPS9 構造体の MaxActiveLights メンバーを確認すると、そのデバイスがサポートするアクティブなライトの最大数を判定できます。

IDirect3DDevice9::SetLight でプロパティが設定されていないライトを有効化または無効化した場合、IDirect3DDevice9::LightEnable メソッドは次の表に示すプロパティを持つ光源を作成し、それを有効または無効にします。

IDirect3DDevice9::LightEnable メソッド (d3d9.h) は、デバイス内の一組のライティング パラメーターを有効または無効にします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

LightIndex の値がデバイス内に割り当てられているライト プロパティ セットの範囲外の場合、IDirect3DDevice9::LightEnable メソッドは次のプロパティを持つ D3DLIGHT9 構造体で表される光源を作成し、その有効状態を bEnable で指定された値に設定します。

</td>

</td>

</td>

</td>

</td>

</td>

</td>

</td>

</td>

</td>

</td>

</td>

</td>

IDirect3DDevice9::GetLightEnable メソッド (d3d9.h) は、デバイス内の一組のライティング パラメーターの有効状態を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

このメソッドは、D3DCREATE_PUREDEVICE を指定して作成されたデバイスではデバイス状態を返しません。このメソッドを使用したい場合は、D3DCREATE の他の値のいずれかを指定してデバイスを作成する必要があります。

IDirect3DDevice9::SetClipPlane メソッド (d3d9.h) は、デバイスのユーザー定義クリッピング プレーンの係数を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL です。このエラーは、Index の値がデバイスがサポートするクリッピング プレーンのインデックスの最大値を超えているか、pPlane が指す配列が 4 つの浮動小数点値を格納するのに十分な大きさでないことを示します。

このメソッドが設定する係数は、一般平面方程式の形式を取ります。pPlane が指す配列内の値を、配列に現れる順に A、B、C、D とすると、これらは一般平面方程式に当てはめられ、Ax + By + Cz + Dw = 0 となります。同次座標 (x, y, z, w) を持つ点は、Ax + By + Cz + Dw >= 0 であれば、その平面の半空間内で可視となります。クリッピング プレーンの背後に存在する点は、シーンからクリップされます。

固定機能パイプラインを使用する場合、平面方程式はワールド空間にあるものと見なされます。プログラマブル パイプラインを使用する場合、平面方程式はクリッピング空間 (出力頂点と同じ空間) にあるものと見なされます。

このメソッドは、設定されるクリッピング プレーン方程式を有効化するわけではありません。クリッピング プレーンを有効にするには、D3DRS_CLIPPLANEENABLE レンダー ステートに適用する DWORD 値の対応するビットを設定します。

IDirect3DDevice9::GetClipPlane メソッド (d3d9.h) は、デバイスのユーザー定義クリッピング プレーンの係数を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL です。このエラーは、Index の値がデバイスがサポートするクリッピング プレーンのインデックスの最大値を超えているか、pPlane が指す配列が 4 つの浮動小数点値を格納するのに十分な大きさでないことを示します。

このメソッドは、D3DCREATE_PUREDEVICE を指定して作成されたデバイスではデバイス状態を返しません。このメソッドを使用したい場合は、D3DCREATE の他の値のいずれかを指定してデバイスを作成する必要があります。"

このメソッドが報告する係数は、一般平面方程式の形式を取ります。pPlane が指す配列内の値を、配列に現れる順に A、B、C、D とすると、これらは一般平面方程式に当てはめられ、Ax + By + Cz + Dw = 0 となります。同次座標 (x, y, z, w) を持つ点は、Ax + By + Cz + Dw >= 0 であれば、その平面の半空間内で可視となります。クリッピング プレーン上またはその背後に存在する点は、シーンからクリップされます。

このメソッドが使用する平面方程式はワールド空間に存在し、事前の IDirect3DDevice9::SetClipPlane メソッドの呼び出しによって設定されます。

IDirect3DDevice9::SetRenderState メソッド (d3d9helper.h) は、デバイスのレンダー ステート パラメーターを 1 つ設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。引数のいずれかが無効な場合は D3DERR_INVALIDCALL が返されます。

IDirect3DDevice9::GetRenderState メソッド (d3d9.h) は、デバイスのレンダー ステートの値を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。引数のいずれかが無効な場合は D3DERR_INVALIDCALL となります。

このメソッドは、D3DCREATE_PUREDEVICE を指定して作成されたデバイスではデバイス状態を返しません。このメソッドを使用したい場合は、D3DCREATE の他の値のいずれかを指定してデバイスを作成する必要があります。"

IDirect3DDevice9::CreateStateBlock メソッド (d3d9.h) は、すべてのデバイス状態、頂点関連の状態、またはピクセル関連の状態の値を格納する新しいステート ブロックを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

頂点関連のデバイス状態とは、通常、システムによる頂点の処理方法に影響する状態を指します。ピクセル関連の状態とは、一般に、ラスタライズ中のピクセル データや深度バッファー データの処理方法に影響するデバイス状態を指します。両方のグループに含まれる状態もあります。

IDirect3DDevice9::BeginStateBlock メソッド (d3d9.h) は、デバイス ステート ブロックの記録を開始するよう Direct3D に指示します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL、E_OUTOFMEMORY。

アプリケーションは、このメソッドを呼び出す前に IDirect3DDevice9::ValidateDevice メソッドを呼び出すことで、記録されるすべての状態が有効であることを確認できます。

IDirect3DDevice9::BeginStateBlock を呼び出した後、IDirect3DDevice9::EndStateBlock を呼び出すまでの間に、次のメソッドをステート ブロックに記録できます。

• IDirect3DDevice9::LightEnable
• IDirect3DDevice9::SetClipPlane
• IDirect3DDevice9::SetCurrentTexturePalette
• IDirect3DDevice9::SetFVF
• IDirect3DDevice9::SetIndices
• IDirect3DDevice9::SetLight
• IDirect3DDevice9::SetMaterial
• IDirect3DDevice9::SetNPatchMode
• IDirect3DDevice9::SetPixelShader
• IDirect3DDevice9::SetPixelShaderConstantB
• IDirect3DDevice9::SetPixelShaderConstantF
• IDirect3DDevice9::SetPixelShaderConstantI
• IDirect3DDevice9::SetRenderState
• IDirect3DDevice9::SetSamplerState
• IDirect3DDevice9::SetScissorRect
• IDirect3DDevice9::SetStreamSource
• IDirect3DDevice9::SetStreamSourceFreq
• IDirect3DDevice9::SetTexture
• IDirect3DDevice9::SetTextureStageState
• IDirect3DDevice9::SetTransform
• IDirect3DDevice9::SetViewport
• IDirect3DDevice9::SetVertexDeclaration
• IDirect3DDevice9::SetVertexShader
• IDirect3DDevice9::SetVertexShaderConstantB
• IDirect3DDevice9::SetVertexShaderConstantF
• IDirect3DDevice9::SetVertexShaderConstantI

IDirect3DDevice9::EndStateBlock メソッド (d3d9.h) は、デバイス ステート ブロックの記録を停止するよう Direct3D に指示し、ステート ブロック インターフェイスへのポインターを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::SetClipStatus メソッド (d3d9.h) は、クリップ ステータスを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。 引数のいずれかが無効な場合、戻り値は D3DERR_INVALIDCALL になります。

クリップ ステータスはソフトウェア頂点処理の際に使用されます。したがって、このメソッドはピュアまたは非ピュアのハードウェア処理デバイスではサポートされません。ピュア デバイスの詳細については、D3DCREATE を参照してください。

頂点処理中に (IDirect3DDevice9::ProcessVertices、IDirect3DDevice9::DrawPrimitive、その他の描画関数によって) クリッピングが有効になっている場合、Direct3D はすべての頂点についてクリップ コードを計算します。クリップ コードは D3DCS_* ビットの組み合わせです。頂点が特定のクリッピング プレーンの外側にある場合、クリッピング コードの対応するビットが設定されます。Direct3D は、ClipUnion および ClipIntersection メンバーを持つ D3DCLIPSTATUS9 を用いてクリップ ステータスを保持します。ClipUnion はすべての頂点クリップ コードのビット単位の "OR"、ClipIntersection はすべての頂点クリップ コードのビット単位の "AND" です。初期値は ClipUnion が 0、ClipIntersection が 0xFFFFFFFF です。D3DRS_CLIPPING が FALSE に設定されている場合、ClipUnion と ClipIntersection は 0 に設定されます。Direct3D は描画呼び出しの際にクリップ ステータスを更新します。特定のオブジェクトについてクリップ ステータスを計算するには、ClipUnion と ClipIntersection を初期値に設定してから描画を続行します。

クリップ ステータスは IDirect3DDevice9::DrawRectPatch および IDirect3DDevice9::DrawTriPatch では更新されません。これらにはソフトウェア エミュレーションが存在しないためです。

IDirect3DDevice9::GetClipStatus メソッド (d3d9.h) は、クリップ ステータスを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。

引数が無効な場合は D3DERR_INVALIDCALL が返されます。

頂点処理中に (IDirect3DDevice9::ProcessVertices、IDirect3DDevice9::DrawPrimitive、その他の描画関数によって) クリッピングが有効になっている場合、Direct3D はすべての頂点についてクリップ コードを計算します。クリップ コードは D3DCS_* ビットの組み合わせです。頂点が特定のクリッピング プレーンの外側にある場合、クリッピング コードの対応するビットが設定されます。Direct3D は、ClipUnion および ClipIntersection メンバーを持つ D3DCLIPSTATUS9 を用いてクリップ ステータスを保持します。ClipUnion はすべての頂点クリップ コードのビット単位の "OR"、ClipIntersection はすべての頂点クリップ コードのビット単位の "AND" です。初期値は ClipUnion が 0、ClipIntersection が 0xFFFFFFFF です。D3DRS_CLIPPING が FALSE に設定されている場合、ClipUnion と ClipIntersection は 0 に設定されます。Direct3D は描画呼び出しの際にクリップ ステータスを更新します。特定のオブジェクトについてクリップ ステータスを計算するには、ClipUnion と ClipIntersection を初期値に設定してから描画を続行します。

クリップ ステータスは IDirect3DDevice9::DrawRectPatch および IDirect3DDevice9::DrawTriPatch では更新されません。これらにはソフトウェア エミュレーションが存在しないためです。

クリップ ステータスはソフトウェア頂点処理の際に使用されます。したがって、このメソッドはピュアまたは非ピュアのハードウェア処理デバイスではサポートされません。ピュア デバイスの詳細については、D3DCREATE を参照してください。

IDirect3DDevice9::GetTexture メソッド (d3d9.h) は、デバイスのステージに割り当てられているテクスチャを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

通常、状態を返すメソッドは D3DCREATE_PUREDEVICE を指定して作成されたデバイスでは動作しません。ただし、このメソッドはインターフェイスを返すため、ピュア デバイスでも動作します。

このメソッドを呼び出すと、IDirect3DTexture9 インターフェイスの内部参照カウントが増加します。この IDirect3DTexture9 インターフェイスの使用を終えた際に IUnknown::Release を呼び出さないと、メモリ リークが発生します。

IDirect3DDevice9::SetTexture メソッド (d3d9helper.h) は、デバイスのステージにテクスチャを割り当てます。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

テクスチャがプール タイプ D3DPOOL_SCRATCH で作成されている場合、SetTexture は使用できません。また、DevCaps に D3DDEVCAPS_TEXTURESYSTEMMEMORY が設定されていない限り、プール タイプ D3DPOOL_SYSTEMMEM のテクスチャに対して SetTexture を使用することはできません。

IDirect3DDevice9::GetTextureStageState メソッド (d3d9.h) は、割り当てられているテクスチャの状態値を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

このメソッドは、D3DCREATE_PUREDEVICE を指定して作成されたデバイスではデバイス状態を返しません。このメソッドを使用したい場合は、D3DCREATE の他のフラグ値のいずれかを指定してデバイスを作成する必要があります。"

IDirect3DDevice9::SetTextureStageState メソッド (d3d9helper.h) は、現在割り当てられているテクスチャの状態値を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

IDirect3DDevice9::GetSamplerState メソッド (d3d9.h) は、サンプラー ステートの値を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

このメソッドは、D3DCREATE_PUREDEVICE を指定して作成されたデバイスではデバイス状態を返しません。このメソッドを使用したい場合は、D3DCREATE の他の値のいずれかを指定してデバイスを作成する必要があります。"

IDirect3DDevice9::SetSamplerState メソッド (d3d9helper.h) は、サンプラー ステートの値を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

IDirect3DDevice9::ValidateDevice メソッド (d3d9.h) は、現在のテクスチャ ブレンド操作および引数を単一パスでレンダリングできるかどうかについて、デバイスの能力を報告します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_CONFLICTINGRENDERSTATE、D3DERR_CONFLICTINGTEXTUREFILTER、D3DERR_DEVICELOST、D3DERR_DRIVERINTERNALERROR、D3DERR_TOOMANYOPERATIONS、D3DERR_UNSUPPORTEDALPHAARG、D3DERR_UNSUPPORTEDALPHAOPERATION、D3DERR_UNSUPPORTEDCOLORARG、D3DERR_UNSUPPORTEDCOLOROPERATION、D3DERR_UNSUPPORTEDFACTORVALUE、D3DERR_UNSUPPORTEDTEXTUREFILTER、D3DERR_WRONGTEXTUREFORMAT。

IDirect3DDevice9::ValidateDevice メソッドは、他の機能情報だけでは判断できない場合にのみ、シナリオの検証に使用してください。たとえば、マルチステージ テクスチャリングのシナリオでは、D3DCAPS9 構造体の MaxTextureBlendStages および MaxSimultaneousTextures メンバーを照会することで、そのデバイスでマルチステージ テクスチャリングが可能かどうかを判定できます。

現行のハードウェアが、操作と引数のあらゆる組み合わせを実装しているとは限りません。特定のブレンド操作を所定の引数で実行できるかどうかは、目的のブレンド操作を設定してから IDirect3DDevice9::ValidateDevice メソッドを呼び出すことで判定できます。

IDirect3DDevice9::ValidateDevice メソッドは、呼び出し時点での現在のレンダー ステート、テクスチャ、テクスチャ ステージ ステートを使用して検証を行います。呼び出し後にこれらの要素を変更すると、それ以前の結果は無効となるため、シーンをレンダリングする前にこのメソッドを再度呼び出す必要があります。

最良のパフォーマンスを得るには、IDirect3DDevice9::ValidateDevice を初期化時に呼び出してください。レンダリング ループ内では使用しないでください。

引数としても操作としても、ディフューズの反復値の使用 (D3DTA_DIFFUSE、D3DTOP_BLENDDIFFUSEALPHA) が現行のハードウェアでサポートされることはまれです。ほとんどのハードウェアでは、反復されたカラー データを導入できるのは最後のテクスチャ操作ステージのみです。

各ステージでは、テクスチャ (D3DTA_TEXTURE) を第 2 引数ではなく第 1 引数として指定するようにしてください。

多くのカードは、任意のテクスチャ ステージでのディフューズ値やスカラー値の使用をサポートしていません。多くの場合、これらは最初または最後のテクスチャ ブレンド ステージでのみ利用できます。

多くのカードでは、最初のテクスチャに関連付けられたブレンド ユニットは、アルファをカラー チャネルに複製する、あるいは入力を反転する程度の機能しか持ちません。そのため、可能であればアプリケーションは 2 番目のテクスチャ ステージのみを使用する必要が生じる場合があります。そのようなハードウェアでは、最初のユニットは既定の状態、すなわち第 1 カラー引数が D3DTA_TEXTURE に設定され、操作が D3DTOP_SELECTARG1 である状態にあると想定されます。

出力アルファに対する操作が、カラー操作より複雑であったり大きく異なっていたりする場合、サポートされる可能性は低くなります。

一部のハードウェアは、D3DTA_TFACTOR と D3DTA_DIFFUSE の同時使用をサポートしていません。

多くのカードは、複数テクスチャとミップマップ トライリニア フィルタリングの同時使用をサポートしていません。マルチテクスチャ ブレンド操作に関与するテクスチャに対してトライリニア フィルタリングを要求して検証が失敗した場合は、トライリニア フィルタリングをオフにして再検証してください。この場合、代わりにマルチパス レンダリングを行うことを検討するとよいでしょう。

IDirect3DDevice9::SetPaletteEntries メソッド (d3d9.h) は、パレット エントリを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

Direct3D 9 アプリケーションでは、このメソッドに渡すパレットは D3DCAPS9 構造体の D3DPTEXTURECAPS_ALPHAPALETTE 機能ビットに従う必要があります。D3DPTEXTURECAPS_ALPHAPALETTE が設定されていない場合、パレットのすべてのエントリでアルファが 1.0 に設定されている必要があり、そうでなければこのメソッドは D3DERR_INVALIDCALL で失敗します。D3DPTEXTURECAPS_ALPHAPALETTE が設定されている場合は、任意のアルファ値の組み合わせが許可されます。なお、すべてのパレット エントリのアルファが 0 に設定されている場合、デバッグ ランタイムは警告メッセージを出力します。

デバイスには単一の論理パレットが関連付けられ、すべてのテクスチャ ステージで共有されます。

IDirect3DDevice9::GetPaletteEntries メソッド (d3d9.h) は、パレット エントリを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

PALETTEENTRY の詳細については、Platform SDK を参照してください。

IDirect3DDevice9::SetCurrentTexturePalette メソッド (d3d9.h) は、現在のテクスチャ パレットを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

デバイスには単一の論理パレットが関連付けられ、すべてのテクスチャ ステージで共有されます。

IDirect3DDevice9::GetCurrentTexturePalette メソッド (d3d9.h) は、現在のテクスチャ パレットを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::SetScissorRect メソッド (d3d9helper.h) は、シザー矩形を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

シザー矩形は、矩形のクリッピング領域として使用されます。

DirectX における矩形の使用方法の詳細については、Rectangles (Direct3D 9) を参照してください。

IDirect3DDevice9::GetScissorRect メソッド (d3d9.h) は、シザー矩形を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

シザー矩形は、矩形のクリッピング領域として使用されます。

DirectX における矩形の使用方法の詳細については、Rectangles (Direct3D 9) を参照してください。

IDirect3DDevice9::SetSoftwareVertexProcessing メソッド (d3d9helper.h) は、ソフトウェア頂点処理モードとハードウェア頂点処理モードを切り替えます。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

モード変更に関する制約は次のとおりです (D3DCREATE 定数に関する注記も参照してください)。

• デバイスが D3DCREATE_SOFTWARE_VERTEXPROCESSING で作成された場合、頂点処理はソフトウェアで行われ、変更できません。
• デバイスが D3DCREATE_HARDWARE_VERTEXPROCESSING で作成された場合、頂点処理はハードウェアで行われ、変更できません。
• デバイスが D3DCREATE_MIXED_VERTEXPROCESSING で作成された場合、頂点処理は既定でハードウェアで行われます。この処理は IDirect3DDevice9::SetSoftwareVertexProcessing を使用してソフトウェアへ (またはハードウェアへ戻すよう) 切り替えられます。

Direct3D 9 では、代わりに SetSoftwareVertexProcessing を使用してください。この新しい API は StateBlocks には記録されません。

IDirect3DDevice9::GetSoftwareVertexProcessing メソッド (d3d9.h) は、頂点処理モード (ハードウェアまたはソフトウェア) を取得します。

型: BOOL

ソフトウェア頂点処理が設定されている場合は TRUE を返します。そうでない場合は FALSE を返します。

アプリケーションは、ソフトウェア頂点処理とハードウェア頂点処理の両方を使用するために混合モードのデバイスを作成できます。DirectX 8.x で 2 つの頂点処理モードを切り替えるには、レンダー ステート D3DRS_SOFTWAREVERTEXPROCESSING と適切な BOOL 引数を指定して IDirect3DDevice9::SetRenderState を使用していました。このレンダー ステートによる方式の欠点は、ステート ブロックのセマンティクスを定義することが難しい点にありました。アプリケーションとランタイムは、ステート ブロックの記録および再生の際に余分な処理を行い、注意を払う必要がありました。

Direct3D 9 では、代わりに IDirect3DDevice9::SetSoftwareVertexProcessing を使用してください。この新しい API は StateBlocks には記録されません。

D3DCREATE 定数に関する注記も参照してください。

IDirect3DDevice9::SetNPatchMode メソッド (d3d9.h) は、N パッチを有効または無効にします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。

IDirect3DDevice9::GetNPatchMode メソッド (d3d9.h) は、N パッチ モードのセグメント数を取得します。

型: FLOAT

分割セグメント数を指定します。セグメント数が 1.0 未満の場合、N パッチは無効になります。既定値は 0.0 です。

IDirect3DDevice9::DrawPrimitive メソッド (d3d9.h) は、現在のデータ入力ストリームのセットから、指定した種類のインデックスなし幾何プリミティブの列をレンダリングします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

既存のアプリケーションを Direct3D 9 へ移行する際は、Draw 系の呼び出しを行う前に、固定機能パイプラインを使用する場合は IDirect3DDevice9::SetFVF の呼び出しを、頂点シェーダーを使用する場合は IDirect3DDevice9::SetVertexDeclaration の呼び出しを追加する必要があります。

IDirect3DDevice9::DrawIndexedPrimitive メソッド (d3d9.h) は、指定した幾何プリミティブを頂点の配列にレンダリングします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

このメソッドは、現在のデータ入力ストリームのセットからインデックス付きプリミティブを描画します。MinIndex およびインデックス ストリーム内のすべてのインデックスは、BaseVertexIndex を基準とします。

MinIndex および NumVertices パラメーターは、各 IDirect3DDevice9::DrawIndexedPrimitive の呼び出しで使用される頂点インデックスの範囲を指定します。これらは、頂点をインデックス参照する前に連続した範囲の頂点を処理することで、インデックス付きプリミティブの頂点処理を最適化するために使用されます。この呼び出しで使用されるインデックスが、この範囲外の頂点を参照することは不正です。

インデックス配列が設定されていない場合、IDirect3DDevice9::DrawIndexedPrimitive は失敗します。

D3DPRIMITIVETYPE 列挙型の D3DPT_POINTLIST メンバーはサポートされておらず、このメソッドでは有効な種類ではありません。

既存のアプリケーションを Direct3D 9 へ移行する際は、Draw 系の呼び出しを行う前に、固定機能パイプラインを使用する場合は IDirect3DDevice9::SetFVF の呼び出しを、頂点シェーダーを使用する場合は IDirect3DDevice9::SetVertexDeclaration の呼び出しを追加する必要があります。

IDirect3DDevice9::DrawPrimitiveUP メソッド (d3d9.h) は、ユーザー メモリ ポインターで指定されたデータを、指定した種類の幾何プリミティブの列としてレンダリングします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

このメソッドは、頂点データを頂点バッファーに格納できないアプリケーションでの使用を意図しています。このメソッドは単一の頂点ストリームのみをサポートします。この呼び出しの効果は、指定された頂点データ ポインターとストライドを頂点ストリーム 0 に使用することです。現在の頂点シェーダーの宣言がストリーム 0 以外の頂点ストリームを参照することは不正です。

IDirect3DDevice9::DrawPrimitiveUP の呼び出し後、IDirect3DDevice9::GetStreamSource が参照するストリーム 0 の設定は NULL に設定されます。

IDirect3DDevice9::DrawPrimitiveUP に渡した頂点データは、呼び出し後も保持し続ける必要はありません。Direct3D は呼び出しから戻る前に、そのデータへのアクセスを完了します。

既存のアプリケーションを Direct3D 9 へ移行する際は、Draw 系の呼び出しを行う前に、固定機能パイプラインを使用する場合は IDirect3DDevice9::SetFVF の呼び出しを、頂点シェーダーを使用する場合は IDirect3DDevice9::SetVertexDeclaration の呼び出しを追加する必要があります。

IDirect3DDevice9::DrawIndexedPrimitiveUP メソッド (d3d9.h) は、ユーザー メモリ ポインターで指定されたデータを用いて、指定した幾何プリミティブをレンダリングします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

このメソッドは、頂点データを頂点バッファーに格納できないアプリケーションでの使用を意図しています。このメソッドは単一の頂点ストリームのみをサポートし、そのストリームはストリーム 0 として宣言されている必要があります。

IDirect3DDevice9::DrawIndexedPrimitiveUP の呼び出し後、IDirect3DDevice9::GetStreamSource が参照するストリーム 0 の設定は NULL に設定されます。また、IDirect3DDevice9::SetIndices のインデックス バッファーの設定も NULL に設定されます。

IDirect3DDevice9::DrawIndexedPrimitiveUP に渡した頂点データは、呼び出し後も保持し続ける必要はありません。Direct3D は呼び出しから戻る前に、そのデータへのアクセスを完了します。

既存のアプリケーションを Direct3D 9 へ移行する際は、Draw 系の呼び出しを行う前に、固定機能パイプラインを使用する場合は IDirect3DDevice9::SetFVF の呼び出しを、頂点シェーダーを使用する場合は IDirect3DDevice9::SetVertexDeclaration の呼び出しを追加する必要があります。

IDirect3DDevice9::ProcessVertices メソッド (d3d9.h) は、頂点シェーダーで定義された頂点処理を、入力データ ストリームのセットに適用します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

このメソッドにおける処理の順序は次のとおりです。

• ワールド行列 + ビュー行列 + 射影行列を用いて、頂点を射影空間へ変換します。
• ビューポート設定を用いてスクリーン座標を計算します。
• クリッピングが有効な場合、クリッピング コードを計算し、コピー先頂点バッファーに関連付けられた内部バッファーへ格納します。頂点が視錐台の内側にある場合、そのスクリーン座標が計算されます。頂点が視錐台の外側にある場合、その頂点は射影空間座標のままコピー先頂点バッファーへ格納されます。
• その他の注意点: ユーザーは内部クリップ コード バッファーにアクセスできません。三角形やその他のプリミティブに対するクリッピングは行われません。

Direct3D がテクスチャ座標を生成する場合、または入力テクスチャ座標をコピーもしくは変換する場合において、出力テクスチャ座標形式が Direct3D の生成するテクスチャ座標成分より多くの成分を定義しているとき、Direct3D はそれらの余分な成分を変更しません。

IDirect3DDevice9::CreateVertexDeclaration メソッド (d3d9.h) は、デバイスと頂点要素から頂点シェーダー宣言を作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

DirectX の各バージョン間で頂点宣言をどのように対応付けるかの詳細については、Vertex Declaration (Direct3D 9) のページを参照してください。

IDirect3DDevice9::SetVertexDeclaration メソッド (d3d9helper.h) は、頂点宣言 (Vertex Declaration、Direct3D 9) を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。 戻り値は D3DERR_INVALIDCALL になることがあります。

頂点宣言は、頂点のデータ メンバー (テクスチャ座標、色、法線など) を定義する IDirect3DVertexDeclaration9 オブジェクトです。このデータは、頂点シェーダーおよびピクセル シェーダーを実装する際に有用です。

IDirect3DDevice9::GetVertexDeclaration メソッド (d3d9.h) は、頂点シェーダー宣言を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。 戻り値は D3DERR_INVALIDCALL になることがあります。

IDirect3DDevice9::SetFVF メソッド (d3d9.h) は、現在の頂点ストリーム宣言を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

位置、ディフューズ色とスペキュラー色、およびテクスチャ座標を持つ頂点を初期化して使用するために必要な手順は次のとおりです。

1. カスタム頂点タイプと FVF コードを定義します。

   
   struct LVertex
   {
       FLOAT    x, y, z;
       D3DCOLOR specular, diffuse;
       FLOAT    tu, tv;
   };
       
   const DWORD VertexFVF = (D3DFVF_XYZ | D3DFVF_DIFFUSE |
                            D3DFVF_SPECULAR | D3DFVF_TEX1 );
   

2. IDirect3DDevice9::CreateVertexBuffer を使用して、4 頂点分の十分な領域を持つ頂点バッファーを作成します。

   
   g_d3dDevice->CreateVertexBuffer( 4*sizeof(LVertex),  
       D3DUSAGE_WRITEONLY, VertexFVF, D3DPOOL_DEFAULT, &pBigSquareVB, NULL );
   

3. 各頂点の値を設定します。

   
   LVertex * v;
   pBigSquareVB->Lock( 0, 0, (BYTE**)&v, 0 );
       
   v[0].x  = 0.0f;  v[0].y  = 10.0;  v[0].z  = 10.0f;
   v[0].diffuse  = 0xffff0000;
   v[0].specular = 0xff00ff00;
   v[0].tu = 0.0f;  v[0].tv = 0.0f;
       
   v[1].x  = 0.0f;  v[1].y  = 0.0f;  v[1].z  = 10.0f;
   v[1].diffuse  = 0xff00ff00;
   v[1].specular = 0xff00ffff;
   v[1].tu = 0.0f;  v[1].tv = 0.0f;
       
   v[2].x  = 10.0f; v[2].y  = 10.0f; v[2].z  = 10.0f;
   v[2].diffuse  = 0xffff00ff;
   v[2].specular = 0xff000000;
   v[2].tu = 0.0f;  v[2].tv = 0.0f;
       
   v[3].x  = 0.0f; v[3].y  = 10.0f;  v[3].z = 10.0f;
   v[3].diffuse  = 0xffffff00;
   v[3].specular = 0xffff0000;
   v[3].tu = 0.0f; v[3].tv = 0.0f;
       
   pBigSquareVB->Unlock();
   

4. 頂点バッファーが初期化され、レンダリングの準備が整いました。次のコード例は、従来の FVF を使用して四角形を描画する方法を示しています。

   
   g_d3dDevice->SetFVF(VertexFVF);
   g_d3dDevice->SetStreamSource(0, pBigSquareVB, 0, sizeof(LVertex));
   g_d3dDevice->DrawPrimitive(D3DPT_TRIANGLESTRIP, 0 ,2);
   

1. カスタム頂点タイプと FVF コードを定義します。

   
   struct Vertex
   {
       FLOAT x, y, z;
       FLOAT nx, ny, nz;
       FLOAT tu, tv;
   };
       
   const DWORD VertexFVF = ( D3DFVF_XYZ | D3DFVF_NORMAL | D3DFVF_TEX1 );
   

2. IDirect3DDevice9::CreateVertexBuffer を使用して、4 頂点分の十分な領域を持つ頂点バッファーを作成します (上記の例と同様)。
3. 各頂点の値を設定します。

   
   Vertex * v;
   pBigSquareVB->Lock(0, 0, (BYTE**)&v, 0);
       
   v[0].x  = 0.0f;  v[0].y  = 10.0;  v[0].z  = 10.0f;
   v[0].nx = 0.0f;  v[0].ny = 1.0f;  v[0].nz = 0.0f;
   v[0].tu = 0.0f;  v[0].tv = 0.0f;
   
   v[1].x  = 0.0f;  v[1].y  = 0.0f;  v[1].z  = 10.0f;
   v[1].nx = 0.0f;  v[1].ny = 1.0f;  v[1].nz = 0.0f;
   v[1].tu = 0.0f;  v[1].tv = 0.0f;
       
   v[2].x  = 10.0f; v[2].y  = 10.0f; v[2].z  = 10.0f;
   v[2].nx = 0.0f;  v[2].ny = 1.0f;  v[2].nz = 0.0f;
   v[2].tu = 0.0f;  v[2].tv = 0.0f;
       
   v[3].x  = 0.0f; v[3].y  = 10.0f;  v[3].z = 10.0f;
   v[3].nx = 0.0f; v[3].ny = 1.0f;   v[3].nz = 0.0f;
   v[3].tu = 0.0f; v[3].tv = 0.0f;
       
   pBigSquareVB->Unlock();
   

4. オブジェクトを描画します (上記の例と同様)。

IDirect3DDevice9::GetFVF メソッド (d3d9.h) は、固定機能頂点宣言を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

固定機能頂点宣言とは、固定機能パイプラインで処理される頂点がどのように使用されるかを決定する FVF フラグの集合です。

IDirect3DDevice9::CreateVertexShader メソッド (d3d9.h) は、頂点シェーダーを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

デバイスの作成時、IDirect3D9::CreateDevice は動作フラグを用いて頂点をハードウェアで処理するかソフトウェアで処理するかを決定します。次の 3 つの選択肢があります。

• D3DCREATE_HARDWARE_VERTEXPROCESSING を設定して、頂点をハードウェアで処理する。
• D3DCREATE_SOFTWARE_VERTEXPROCESSING を設定して、頂点をソフトウェアで処理する。
• D3DCREATE_MIXED_VERTEXPROCESSING を設定して、頂点をハードウェアまたはソフトウェアのいずれかで処理する。混合モードのデバイスでソフトウェア処理とハードウェア処理を切り替えるには、IDirect3DDevice9::SetSoftwareVertexProcessing を使用します。

IDirect3DDevice9::SetVertexShader メソッド (d3d9helper.h) は、頂点シェーダーを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

(プログラマブル頂点シェーダーを設定した後に) 固定機能の頂点シェーダーを設定するには、IDirect3DDevice9::SetVertexShader(NULL) を呼び出してプログラマブル シェーダーを解放し、その後、固定機能の頂点フォーマットを指定して IDirect3DDevice9::SetFVF を呼び出します。

IDirect3DDevice9::GetVertexShader メソッド (d3d9.h) は、現在設定されている頂点シェーダーを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。 ppShader が無効な場合は D3DERR_INVALIDCALL が返されます。

通常、状態を返すメソッドは D3DCREATE_PUREDEVICE を指定して作成されたデバイスでは動作しません。ただし、このメソッドはインターフェイスを返すため、ピュア デバイスでも動作します。

IDirect3DDevice9::SetVertexShaderConstantF メソッド (d3d9helper.h) は、浮動小数点の頂点シェーダー定数を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::GetVertexShaderConstantF メソッド (d3d9.h) は、浮動小数点の頂点シェーダー定数を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::SetVertexShaderConstantI メソッド (d3d9helper.h) は、整数の頂点シェーダー定数を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::GetVertexShaderConstantI メソッド (d3d9.h) は、整数の頂点シェーダー定数を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::SetVertexShaderConstantB メソッド (d3d9helper.h) は、ブール値の頂点シェーダー定数を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::GetVertexShaderConstantB メソッド (d3d9.h) は、ブール値の頂点シェーダー定数を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::SetStreamSource メソッド (d3d9helper.h) は、頂点バッファーをデバイスのデータ ストリームにバインドします。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

FVF 頂点シェーダーを使用する場合、頂点ストリームのストライドは FVF から算出される頂点サイズと一致していなければなりません。宣言 (declaration) を使用する場合、ストライドは宣言から算出されるストリーム サイズ以上である必要があります。

SetStreamSource を呼び出す際、通常はストライドが頂点サイズと等しいことが要求されます。ただし、同一または類似のジオメトリのインスタンスを複数描画したい場合 (インスタンシングによる描画を行う場合など) があります。この場合は、ストライドに 0 を指定して、頂点バッファーのオフセットを進めないようランタイムに指示します (すなわち、すべてのインスタンスで同じ頂点データを使用します)。インスタンシングの詳細については、Efficiently Drawing Multiple Instances of Geometry (Direct3D 9) を参照してください。

IDirect3DDevice9::GetStreamSource メソッド (d3d9.h) は、指定したデータ ストリームにバインドされている頂点バッファーを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

ストリームとは、コンポーネント データの均一な配列として定義されます。各コンポーネントは、位置、法線、色などの単一の実体を表す 1 つ以上の要素で構成されます。

FVF 頂点シェーダーを使用する場合、頂点ストリームのストライドは FVF から算出される頂点サイズと一致していなければなりません。宣言 (declaration) を使用する場合、ストライドは宣言から算出されるストリーム サイズ以上である必要があります。

このメソッドを呼び出すと、IDirect3DVertexBuffer9 インターフェイスの内部参照カウントが増加します。この IDirect3DVertexBuffer9 インターフェイスの使用を終えた際に IUnknown::Release を呼び出さないと、メモリ リークが発生します。

IDirect3DDevice9::SetStreamSourceFreq メソッド (d3d9helper.h) は、ストリーム ソースの周波数分周値を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

d3d9types.h には、SetStreamSourceFreq で使用するために設計された 2 つの定数、D3DSTREAMSOURCE_INDEXEDDATA と D3DSTREAMSOURCE_INSTANCEDATA が定義されています。これらの定数の使用方法については、Efficiently Drawing Multiple Instances of Geometry (Direct3D 9) を参照してください。

IDirect3DDevice9::GetStreamSourceFreq メソッド (d3d9.h) は、ストリーム ソースの周波数分周値を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

頂点シェーダーは、頂点あたり複数回呼び出せるようになりました。Drawing Non-Indexed Geometry を参照してください。

IDirect3DDevice9::SetIndices メソッド (d3d9.h) は、インデックス データを設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

アプリケーションがこのインターフェイスへの参照を保持しなくなると、インターフェイスは自動的に解放されます。

IDirect3DDevice9::SetIndices メソッドは、現在のインデックス配列をインデックス バッファーに設定します。この単一のインデックス セットが、すべてのストリームのインデックス参照に使用されます。

IDirect3DDevice9::GetIndices メソッド (d3d9.h) は、インデックス データを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

このメソッドを呼び出すと、IDirect3DIndexBuffer9 インターフェイスの内部参照カウントが増加します。この IDirect3DIndexBuffer9 インターフェイスの使用を終えた際に IUnknown::Release を呼び出さないと、メモリ リークが発生します。

IDirect3DDevice9::CreatePixelShader メソッド (d3d9.h) は、ピクセル シェーダーを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、 E_OUTOFMEMORY。

IDirect3DDevice9::SetPixelShader メソッド (d3d9.h) は、事前に作成されたピクセル シェーダーを現在のピクセル シェーダーとして設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

IDirect3DDevice9::GetPixelShader メソッド (d3d9.h) は、現在設定されているピクセル シェーダーを取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

このメソッドは、D3DCREATE_PUREDEVICE を指定して作成されたデバイスでは動作しません。

IDirect3DDevice9::SetPixelShaderConstantF メソッド (d3d9helper.h) は、浮動小数点のシェーダー定数を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::GetPixelShaderConstantF メソッド (d3d9.h) は、浮動小数点のシェーダー定数を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::SetPixelShaderConstantI メソッド (d3d9helper.h) は、整数のシェーダー定数を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::GetPixelShaderConstantI メソッド (d3d9.h) は、整数のシェーダー定数を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::SetPixelShaderConstantB メソッド (d3d9.h) は、ブール値のシェーダー定数を設定します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::GetPixelShaderConstantB メソッド (d3d9.h) は、ブール値のシェーダー定数を取得します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::DrawRectPatch メソッド (d3d9.h) は、現在設定されているストリームを使用して矩形パッチを描画します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

静的パッチの場合: 頂点シェーダーを設定し、適切なストリームを設定し、pRectPatchInfo パラメーターにパッチ情報を指定したうえで、Direct3D が情報をキャプチャしてキャッシュできるようにハンドルを指定します。その後、pRectPatchInfo を NULL にして IDirect3DDevice9::DrawRectPatch を呼び出すことで、パッチを効率的に描画できます。キャッシュされたパッチを描画する際、現在設定されているストリームは無視されます。キャッシュされた pNumSegs は、新しい pNumSegs の値を指定することで上書きできます。キャッシュされたパッチをレンダリングする際は、キャプチャ時に設定されていたのと同じ頂点シェーダーを設定する必要があります。

ハンドルを指定して IDirect3DDevice9::DrawRectPatch を呼び出すと、それ以前の IDirect3DDevice9::DrawTriPatch の呼び出しでキャッシュされた同じハンドルは無効になります。

動的パッチの場合、パッチ データはパッチをレンダリングするたびに変化するため、情報をキャッシュしても効率的ではありません。アプリケーションは、Handle を 0 に設定することでこれを Direct3D に伝えられます。この場合、Direct3D は現在設定されているストリームと pNumSegs の値を使用してパッチを描画し、情報をキャッシュしません。Handle を 0 に設定すると同時に pRectPatchInfo を NULL にすることは不正です。

IDirect3DDevice9::DrawTriPatch メソッド (d3d9.h) は、現在設定されているストリームを使用して三角形パッチを描画します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

静的パッチの場合: 頂点シェーダーを設定し、適切なストリームを設定し、pTriPatchInfo パラメーターにパッチ情報を指定したうえで、Direct3D が情報をキャプチャしてキャッシュできるようにハンドルを指定します。パッチを効率的に描画するには、pTriPatchInfo を NULL にして IDirect3DDevice9::DrawTriPatch を呼び出します。キャッシュされたパッチを描画する際、現在設定されているストリームは無視されます。キャッシュされた pNumSegs は、新しい pNumSegs の値を指定することで上書きできます。キャッシュされたパッチをレンダリングする際は、キャプチャ時に設定されていたのと同じ頂点シェーダーを設定する必要があります。

ハンドルを指定して IDirect3DDevice9::DrawTriPatch を呼び出すと、それ以前の IDirect3DDevice9::DrawRectPatch の呼び出しでキャッシュされた同じハンドルは無効になります。

動的パッチの場合、パッチ データはパッチをレンダリングするたびに変化するため、情報をキャッシュしても効率的ではありません。アプリケーションは、Handle を 0 に設定することでこれを Direct3D に伝えられます。この場合、Direct3D は現在設定されているストリームと pNumSegs の値を使用してパッチを描画し、情報をキャッシュしません。Handle を 0 に設定すると同時に pTriPatchInfo を NULL にすることは不正です。

IDirect3DDevice9::DeletePatch メソッド (d3d9.h) は、キャッシュされた高次パッチを解放します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

IDirect3DDevice9::CreateQuery メソッド (d3d9.h) は、ステータス クエリを作成します。

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は D3DERR_NOTAVAILABLE または E_OUTOFMEMORY になります。

このメソッドは、同期クエリと非同期クエリの両方のために提供されています。Direct3D 9 でサポートされなくなった GetInfo に代わるものです。

同期クエリおよび非同期クエリは、D3DQUERYTYPE を指定して IDirect3DDevice9::CreateQuery で作成します。クエリを作成し、クエリ対象となる API 呼び出しを行った後、IDirect3DQuery9::Issue を使用してクエリを発行し、IDirect3DQuery9::GetData を使用してクエリの結果を取得します。