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

こちらもご覧ください

DXGKARGCB_PINFRAMEBUFFERFORSAVE2

DXGKARGCB_PINFRAMEBUFFERFORSAVE

DXGKCB_UNPINFRAMEBUFFERFORSAVE