DXGI_SWAP_CHAIN_DESC 構造体 (dxgi.h)

  • [アーティクル]

スワップ チェーンについて説明します。

構文

typedef struct DXGI_SWAP_CHAIN_DESC {
  DXGI_MODE_DESC   BufferDesc;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  HWND             OutputWindow;
  BOOL             Windowed;
  DXGI_SWAP_EFFECT SwapEffect;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC;

メンバー

BufferDesc

種類: DXGI_MODE_DESC

バックバッファー表示モードを記述する DXGI_MODE_DESC 構造体。

SampleDesc

種類: DXGI_SAMPLE_DESC

マルチサンプリング パラメーターを記述する DXGI_SAMPLE_DESC 構造体。

BufferUsage

種類: DXGI_USAGE

バック バッファーのサーフェス使用量と CPU アクセス オプションを記述する、 DXGI_USAGE 列挙型のメンバー。 バック バッファーは、シェーダー入力またはレンダー ターゲット出力に使用できます。

BufferCount

型: UINT

スワップ チェーン内のバッファーの数を表す 値。 IDXGIFactory::CreateSwapChain を呼び出して全画面表示のスワップ チェーンを作成する場合は、通常、この値にフロント バッファーを含めます。 スワップ チェーン バッファーの詳細については、「解説」を参照してください。

OutputWindow

種類: HWND

出力ウィンドウへの HWND ハンドル。 このメンバーは NULL にすることはできません。

Windowed

種類: BOOL

出力がウィンドウ モードであるかどうかを示すブール値。 出力 がウィンドウ モードの場合は TRUE。それ以外の場合は FALSE。

ウィンドウ化されたスワップ チェーンを作成し、エンド ユーザーが IDXGISwapChain::SetFullscreenState を使用してスワップ チェーンを全画面表示に変更できるようにすることをお勧めします。つまり、スワップ チェーンを強制的に全画面表示にするには、このメンバーを FALSE に設定しないでください。 ただし、スワップ チェーンを全画面表示として作成する場合は、サポートされていない表示モードで作成されたスワップ チェーンによってディスプレイが黒になり、エンド ユーザーに何も表示されない可能性があるため、 BufferDesc メンバーを介してサポートされている表示モードの一覧をエンド ユーザーに提供します。

ウィンドウ化された詩の全画面表示の選択の詳細については、「 IDXGIFactory::CreateSwapChain」を参照してください。

SwapEffect

種類: DXGI_SWAP_EFFECT

サーフェスを表示した後にプレゼンテーション バッファーの内容を処理するためのオプションを記述する、 DXGI_SWAP_EFFECT 列挙型のメンバー。

Flags

型: UINT

スワップ チェーン動作のオプションを記述する DXGI_SWAP_CHAIN_FLAG 列挙型のメンバー。

解説

この構造体は、 GetDesc メソッドと CreateSwapChain メソッドで使用されます。

全画面表示モードでは、専用のフロント バッファーがあります。ウィンドウ モードでは、デスクトップはフロント バッファーです。

1 つのバッファーでスワップ チェーンを作成した場合、 DXGI_SWAP_EFFECT_SEQUENTIAL を指定しても、1 つのバッファーの内容がフロント バッファーとスワップされることはありません。

全画面表示アプリケーションでのスワップ チェーン バッファーの反転に関するパフォーマンス情報については、「全画面表示 アプリケーションのパフォーマンス ヒント」を参照してください。

要件

   
Header dxgi.h

関連項目

DXGI 構造体

IDXGIFactory::CreateSwapChain

IDXGISwapChain