DXGI_DDI_ARG_PRESENT1構造体 (dxgiddi.h)

[アーティクル]
02/06/2025

表示するリソースについて説明します。 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 ソース四角形を基準とするダーティ四角形 (RECTs) の配列へのポインター。

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

[in] DirtyRects

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

BackBufferMultiplicity

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 8.1、WDDM 1.3 以降
サポートされる最小サーバー	Windows Server 2012 R2
ヘッダー	dxgiddi.h (D3d10umddi.h を含む)

次の方法で共有

DXGI_DDI_ARG_PRESENT1構造体 (dxgiddi.h)

構文

メンバーズ

必要条件

関連項目

フィードバック

その他のリソース