DXGI_DDI_ARG_PRESENT1 構造体 (dxgiddi.h)

表示するリソースについて説明します。 Windows ディスプレイ ドライバー モデル (WDDM) 1.3 以降のユーザー モード ディスプレイ ドライバーによって pfnPresent1 (DXGI) 関数と共に使用されます。

構文

typedef struct DXGI_DDI_ARG_PRESENT1 {
  [in] DXGI_DDI_HDEVICE                  hDevice;
  [in] const DXGI_DDI_ARG_PRESENTSURFACE *phSurfacesToPresent;
  [in] UINT                              SurfacesToPresent;
  [in] DXGI_DDI_HRESOURCE                hDstResource;
  [in] UINT                              DstSubResourceIndex;
  [in] void                              *pDXGIContext;
  [in] DXGI_DDI_PRESENT_FLAGS            Flags;
  [in] DXGI_DDI_FLIP_INTERVAL_TYPE       FlipInterval;
       UINT                              Reserved;
  [in] const RECT                        *pDirtyRects;
  [in] UINT                              DirtyRects;
       UINT                              BackBufferMultiplicity;
} DXGI_DDI_ARG_PRESENT1;

メンバー

[in] hDevice

ドライバーがプレゼンテーションを実行するディスプレイ デバイス (グラフィックス コンテキスト) へのハンドル。 Direct3D ランタイムは、ランタイムがドライバーの CreateDevice(D3D10) 関数を呼び出してディスプレイ デバイスを作成するときに、D3D10DDIARG_CREATEDEVICE構造体の hDrvDevice メンバー内のドライバーにこのハンドルを渡します。

[in] phSurfacesToPresent

NULL 以外のハンドルと、表示または解放するソース リソースへの 0 から始まるインデックスの配列。 phSurfacesToPresent は、常にリソースを表示するための有効なハンドルです。

[in] SurfacesToPresent

表示するサーフェスの配列。 0 にすることはできません。

[in] hDstResource

表示先のリソースへのハンドル。宛先が不明な場合は 、hDstResource を NULL にすることができます 。カーネル モードは、DMA 経由でハードウェア コマンド ストリームをグラフィックス プロセッサに送信する直前に、宛先を決定します。

多数のリソースが表示されている場合、 hDstResource は NULL になり、ドライバーは pfnPresentCb 関数で使用するために、最後のソース リソース ハンドルのみを変換する必要があります。

[in] DstSubResourceIndex

hDstResource メンバーのハンドルが指定する、宛先リソースへの 0 から始まるインデックス。 DstSubResourceIndex インデックスは、表示するサブリソースまたはサーフェスを示します。

[in] pDXGIContext

DXGI コンテキストへのハンドル。 このハンドルはドライバーに対して不透明です。 ドライバーは、pfnPresentCbDXGI 関数を呼び出すときに、DXGIDDICB_PRESENT構造体の pDXGIContext メンバーとしてこのメンバーのハンドルを渡す必要があります。

[in] Flags

ビット フィールド フラグで、現在の操作の実行方法を識別するDXGI_DDI_PRESENT_FLAGS構造体。

[in] FlipInterval

反転間隔を示す DXGI_DDI_FLIP_INTERVAL_TYPE型指定された値 (つまり、0、1、2、3、または 4 つの垂直同期の後に反転が発生した場合)。

Reserved

このメンバーは予約されており、0 に設定する必要があります。

[in] pDirtyRects

変更されたオーバーレイ平面の部分を示す、ソース四角形 SrcRect に対する相対ダーティ四角形 (RECT) の配列へのポインター。

ドライバーは、このメンバーを使用して最適化を実行できますが、ダーティ四角形の情報を使用する必要はありません。 ただし、ドライバーは、指定されたダーティ四角形に基づいて関数呼び出しを失敗させるべきではありません。

[in] DirtyRects

pDirtyRects が指す配列内のダーティ四角形の数。

BackBufferMultiplicity

論理バック バッファーあたりの物理バック バッファーの数。

要件

こちらもご覧ください

CreateDevice(D3D10)

DXGIDDICB_PRESENT

DXGI_DDI_FLIP_INTERVAL_TYPE

DXGI_DDI_PRESENT_FLAGS

Rect

pfnPresent1(DXGI)

pfnPresentCb

pfnPresentCbDXGI