DXGKCB_PINFRAMEBUFFERFORSAVE2 コールバック関数 (d3dkmddi.h)
カーネル モードディスプレイ ミニポート ドライバーは、フレーム バッファー全体を一度にピン留めする DXGKCB_PINFRAMEBUFFERFORSAVE2 を呼び出します。
構文
DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;
NTSTATUS DxgkcbPinframebufferforsave2(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARGCB_PINFRAMEBUFFERFORSAVE2 pPinFrameBufferForSave2
)
{...}
パラメーター
[in] hAdapter
ディスプレイ アダプターへのハンドル。 ドライバーは、リンクされたディスプレイ アダプター (LDA) チェーン内のメイン/リード デバイスのこのハンドルを提供します。
[in/out] pPinFrameBufferForSave2
保存するフレーム バッファーに関する情報を含む DXGKARGCB_PINFRAMEBUFFERFORSAVE2 構造体へのポインター。
戻り値
操作が成功した場合、DXGKCB_PINFRAMEBUFFERFORSAVE2 はSTATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS エラー コードを返します。
備考
WDDM 2.4 IOMMU 実装 元の には、フレーム バッファーを保存するために必要なメモリを照会するためのコールバック関数のペアが含まれていました。 フレーム バッファーの保存領域は初期化中にセクション オブジェクトとして作成され、ドライバーはこれらのコールバックを使用して、必要に応じて IOMMU マップ領域を取得しました。
アドレス記述子リスト (ACL) を使用して論理 DMA の再マッピングをサポートするドライバーは、DXGKARGCB_PINFRAMEBUFFERFORSAVEの代わりに DXGKCB_PINFRAMEBUFFERFORSAVE2 を実装します。
DXGKCB_PINFRAMEBUFFERFORSAVE2 を使用してピン留めされたメモリは、元の DXGKCB_UNPINFRAMEBUFFERFORSAVE コールバックを使用してピン留め解除できます。
詳細については、IOMMU DMA の再マップ を参照してください。
DXGKCB_XXX 関数は、Dxgkrnlによって実装されます。 このコールバック関数を使用するには、DXGKARGCB_PINFRAMEBUFFERFORSAVE2 の適切なメンバーを設定し、DXGKRNL_INTERFACEを介して DxgkCbPinFrameBufferForSave2 呼び出します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小サーバー | Windows Server 2022 (WDDM 2.9) |
| ヘッダー | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |
関連項目
DXGKARGCB_PINFRAMEBUFFERFORSAVE2