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) |
| Header | d3dkmddi.h |