DXGKCB_MAPMDLTOIOMMU コールバック関数 (d3dkmddi.h)

[アーティクル]
02/26/2024

カーネルモードディスプレイミニポートドライバーは、基になるメモリに GPU でアクセスできるように、メモリ記述子リスト (MDL) を IOMMU にマップするDXGKCB_MAPMDLTOIOMMUを呼び出します。

構文

DXGKCB_MAPMDLTOIOMMU DxgkcbMapmdltoiommu;

NTSTATUS DxgkcbMapmdltoiommu(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_MAPMDLTOIOMMU pMapMdlToIoMmu
)
{...}

パラメーター

[in] hAdapter

ディスプレイアダプターへのハンドル。ドライバーは、LDA チェーン内のマスター/リードデバイスに対してこのハンドルを提供します。

[in/out] pMapMdlToIoMmu

メモリへのハンドルを含む DXGKARGCB_MAPMDLTOIOMMU 構造体へのポインター。

戻り値

操作が成功した場合は、STATUS_SUCCESSを返します。それ以外の場合は、適切な NTSTATUS 値エラーコードを返します。

注釈

DXGKCB_XXX 関数は Dxgkrnl によって実装されます。このコールバック関数を使用するには、DXGKARGCB_MAPMDLTOIOMMUの適切なメンバーを設定し、DXGKRNL_INTERFACE経由で DxgkCbMapMdlToIoMmu を呼び出します。

ドライバーがこのコールバックを使用する場合は、MDL の有効期間が対応する DXGKCB_UNMAPMDLFROMIOMMU 呼び出しを超えるかどうかを確認する必要があります。そうしないと 、DXGKCB_UNMAPMDLFROMIOMMU 呼び出しの動作が未定義になり、MDL からのページのセキュリティが侵害される可能性があります。ページはマップ解除された時点で Mm によって再利用される可能性があります。

詳細については、「 IOMMU ベースの GPU 分離」を参照してください。