DXGKCB_MAPMDLTOIOMMU回呼函式 (d3dkmddi.h)

發行項
02/23/2024

核心模式顯示迷你埠驅動程式會呼叫 DXGKCB_MAPMDLTOIOMMU ，將記憶體描述元清單 (MDL) 對應至 IOMMU，讓 GPU 可以存取基礎記憶體。

語法

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 隔離。