次の方法で共有

DXGKARGCB_PINFRAMEBUFFERFORSAVE2構造体 (d3dkmddi.h)

  • [アーティクル]

DXGKARGCB_PINFRAMEBUFFERFORSAVE2 構造体には、フレーム バッファー全体を一度にピン留めするために DXGKCB_PINFRAMEBUFFERFORSAVE2 コールバック関数によって使用される情報が含まれています。

構文

typedef struct _DXGKARGCB_PINFRAMEBUFFERFORSAVE2 {
  [in]  UINT     PhysicalAdapterIndex;
  [in]  SIZE_T   CommitSize;
  union {
    struct {
      UINT PreferContiguous : 1;
      UINT Reserved : 31;
    };
          UINT Value;
  } Flags;
  [out] DXGK_ADL *pAdl;
} DXGKARGCB_PINFRAMEBUFFERFORSAVE2;

メンバーズ

[in] PhysicalAdapterIndex

物理アダプターのインデックス。

[in] CommitSize

ドライバーがピン留めするために必要なサイズ (バイト単位)。 このサイズは、PAGE_SIZEの倍数である必要があり、ドライバーの初期化中にドライバーの DxgkDdiQueryAdapterInfo コールバックが DXGKQAITYPE_FRAMEBUFFERSAVESIZE で呼び出されたときに、DXGK_FRAMEBUFFERSAVEAREA 構造体でドライバーによって指定された最大サイズ以下である必要があります。

Flags

Flags.PreferContiguous

ドライバーは、このパスで連続したアドレス記述子リスト (ADL) を使用でき、ページ配列に適していることを示します。 論理再マップが有効になっている場合、CommitSize に基づいて ADL を割り当てるときに大量のメモリが節約される可能性があります。 このフラグは、ADL を割り当てるときに、DXGKARGCB_ALLOCATE_ADL の同じ名前のフラグ同じように動作します。

Flags.Reserved

引っ込み思案;0 に設定する必要があります。

Flags.Value

Flags ビットにアクセスする別の方法。

[out] pAdl

DXGKCB_PINFRAMEBUFFERFORSAVE2の呼び出しが成功すると、フレーム バッファーの保存領域のページの一覧を持つ DXGK_ADL 構造体を指します。 これらのページは、IoMmu にマップすることが保証されます。

備考

詳細については、IOMMU DMA の再マップ を参照してください。

必要条件

要件 価値
サポートされる最小サーバー Windows Server 2022 (WDDM 2.9)
ヘッダー d3dkmddi.h

関連項目

DXGK_ADL

DXGK_FRAMEBUFFERSAVEAREA

DXGKCB_PINFRAMEBUFFERFORSAVE2

DxgkDdiQueryAdapterInfoの