D3DPRESENT_PARAMETERS

[アーティクル]
04/08/2010

プレゼンテーションパラメーターを記述します。

typedef struct D3DPRESENT_PARAMETERS {
    UINT BackBufferWidth, BackBufferHeight;
    D3DFORMAT BackBufferFormat;
    UINT BackBufferCount;
    D3DMULTISAMPLE_TYPE MultiSampleType;
    DWORD MultiSampleQuality;
    D3DSWAPEFFECT SwapEffect;
    HWND hDeviceWindow;
    BOOL Windowed;
    BOOL EnableAutoDepthStencil;
    D3DFORMAT AutoDepthStencilFormat;
    DWORD Flags;
    UINT FullScreen_RefreshRateInHz;
    UINT PresentationInterval;
} D3DPRESENT_PARAMETERS, *LPD3DPRESENT_PARAMETERS;

メンバ

BackBufferWidth, BackBufferHeight
新しいスワップチェーンのバックバッファーの幅および高さ (ピクセル単位) です。Windowed が FALSE (プレゼンテーションが全画面) の場合、これらの値は IDirect3D9::EnumAdapterModes によって検出され列挙された表示モードの 1 つの幅および高さに等しくなければなりません。Windowed が TRUE で、これらの値のいずれかがゼロの場合は、hDeviceWindow (hDeviceWindow が NULL の場合はフォーカスウィンドウ) のクライアント領域の対応するディメンションが使用されます。
BackBufferFormat
バックバッファーのフォーマットです。フォーマットの詳細については、「D3DFORMAT」を参照してください。この値は、IDirect3D9::CheckDeviceType により検証されたいずれかのレンダーターゲットフォーマットでなければなりません。現在のフォーマットは、IDirect3DDevice9::GetDisplayMode を使用して取得できます。
実際、ウィンドウモードの場合、BackBufferFormat では D3DFMT_UNKNOWN を指定できます。これにより、ランタイムは現在の表示モードフォーマットを使用するよう指示されるので、IDirect3DDevice9::GetDisplayMode を呼び出す必要がありません。ウィンドウアプリケーションの場合、カラー変換はハードウェアによって実行できるようになっている (カラー変換をハードウェアがサポートしている場合) ので、バックバッファーフォーマットは表示モードフォーマットに一致する必要はありません。可能なバックバッファーフォーマットのセットは制限されていますが、実行時には、すべての有効なバックバッファーフォーマットが各デスクトップフォーマットで表現されます。デバイスは、通常、ピクセルあたり 8 ビットのモードでは動作しないので、デスクトップモードで動作するための追加要件があります。フルスクリーンアプリケーションはカラー変換を実行できません。
BackBufferCount
この値には、0 ～ D3DPRESENT_BACK_BUFFERS_MAX (Direct3D 9Ex の使用時は D3DPRESENT_BACK_BUFFERS_MAX_EX) の範囲の値を指定することができます。値 0 は、値 1 として処理されます。指定された数だけバックバッファーを作成することができないと、ランタイムはメソッドの呼び出しに失敗し、作成できたバックバッファーの数をこの値に設定します。そのため、アプリケーションは、メソッドを同じ D3DPRESENT_PARAMETERS 構造体を使用して 2 回呼び出し、2 回目に機能するのを待つことがあります。
メソッドは、バックバッファーを 1 つ作成できないと、失敗します。BackBufferCount の値は、許可されるスワップエフェクトのセットに影響を与えます。具体的に言うと、D3DSWAPEFFECT_COPY スワップエフェクトの場合は常に、バックバッファーが 1 つだけ存在する必要があります。
MultiSampleType
D3DMULTISAMPLE_TYPE 列挙型のメンバーです。SwapEffect が D3DSWAPEFFECT_DISCARD に設定されていない場合、この値は D3DMULTISAMPLE_NONE でなければなりません。スワップエフェクトが D3DSWAPEFFECT_DISCARD の場合のみ、マルチサンプリングがサポートされます。
MultiSampleQuality
品質レベルです。有効な範囲は、0 から、IDirect3D9::CheckDeviceMultiSampleType の pQualityLevels が返すレベル - 1 までです。それより大きな値を渡すと、エラー D3DERR_INVALIDCALL が返されます。レンダーターゲットまたは深度ステンシルサーフェスと D3DMULTISAMPLE_TYPE の対になる値は、一致する必要があります。

SwapEffect
D3DSWAPEFFECT 列挙型のメンバーです。バッファーのスワップ動作に関する暗黙的なセマンティクスは、ランタイムによって保証されます。そのため、Windowed が TRUE で SwapEffect が D3DSWAPEFFECT_FLIP に設定されている場合、ランタイムはバックバッファーを 1 つ余分に作成し、プレゼンテーション時にフロントバッファーになったものをコピーします。
D3DSWAPEFFECT_COPY の場合は、BackBufferCount を 1 に設定する必要があります。 D3DSWAPEFFECT_DISCARD は、デバッグランタイム時、プレゼンテーション後にバッファーにノイズを格納することにより適用されます。

Direct3D9 と Direct3D9Ex の違い

Direct3D9Ex では、アプリケーションでフリップモードを使用するときに指定する D3DSWAPEFFECT_FLIPEX が追加されています。これは、画面を合成するためにウィンドウモードでアプリケーションのフレームをデスクトップウィンドウマネージャー (DWM) に (コピーするのではなく) 渡すときに指定するフラグです。フリップモードでは、メモリー帯域幅を効率的に使用でき、アプリケーションで全画面表示の統計情報を活用できるようになります。フリップモードでも全画面の動作は変わりません。フリップモードの動作は Windows 7 以降で利用できます。

hDeviceWindow
画面上のバックバッファーの位置とサイズは、デバイスウィンドウによって決定されます。これは、IDirect3DDevice9::Present の際にバックバッファーの内容がフロントバッファーにコピーされるとき、Direct3D によって使用されます。
全画面アプリケーションの場合は、最上位ウィンドウ (フォーカスウィンドウ) へのハンドルです。

全画面デバイスを複数使用するアプリケーション (マルチモニターシステムなど) の場合、フォーカスウィンドウをデバイスウィンドウとして使用できるデバイスは 1 つだけです。他のデバイスはすべて、一意なデバイスウィンドウを持つ必要があります。
ウィンドウモードのアプリケーションの場合、このハンドルは IDirect3DDevice9::Present の既定のターゲットウィンドウになります。このハンドルが NULL の場合は、フォーカスウィンドウが使用されます。

ユーザーによるウィンドウサイズの変更を反映するために、ランタイムは何も実行しない点に注意してください。このウィンドウのリセット時、バックバッファーは暗黙的にリセットされません。ただし、IDirect3DDevice9::Present メソッドは、ウィンドウの位置の変更を自動的に追跡します。
Windowed
アプリケーションがウィンドウモードで実行される場合は TRUE。アプリケーションが全画面モードで実行される場合は FALSE。
EnableAutoDepthStencil
この値に TRUE を指定すると、Direct3D がアプリケーションの深度バッファーを管理します。作成したデバイスによって、深度ステンシルバッファーが作成されます。深度ステンシルバッファーは、デバイスのレンダーターゲットとして自動的に設定されます。デバイスがリセットされると、深度ステンシルバッファーは自動的に破棄され、新たなサイズで再作成されます。 EnableAutoDepthStencil が TRUE の場合、AutoDepthStencilFormat には有効な深度ステンシルフォーマットを指定する必要があります。
AutoDepthStencilFormat
D3DFORMAT 列挙型のメンバーです。デバイスが作成する自動深度ステンシルサーフェスのフォーマットです。EnableAutoDepthStencil が TRUE でない場合、このメンバーは無視されます。
Flags
D3DPRESENTFLAG 定数の 1 つです。
FullScreen_RefreshRateInHz
ディスプレイアダプターによるスクリーンのリフレッシュレートです。この値は、アプリケーションの実行モードによって異なります。
- ウィンドウモードの場合、リフレッシュレートは 0 でなければなりません。
- 全画面モードの場合、リフレッシュレートは IDirect3D9::EnumAdapterModes によって返されるリフレッシュレートの 1 つです。
PresentationInterval
スワップチェーンのバックバッファーをフロントバッファーに表示できる最大速度です。サポートされているモードと間隔の詳細については、「D3DPRESENT」を参照してください。

要件

ヘッダー: D3D9Types.h 宣言

次の方法で共有

D3DPRESENT_PARAMETERS

メンバ

要件

関連項目

その他のリソース