共用方式為


DXGKCB_ALLOCATEPAGESFORMDL回呼函式 (d3dkmddi.h)

DXGKCB_ALLOCATEPAGESFORMDL 配置實體記憶體分頁給要對應到 IOMMU 邏輯位址空間的記憶體描述元清單 (MDL)。

語法

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

NTSTATUS DxgkcbAllocatepagesformdl(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_ALLOCATEPAGESFORMDL pAllocatePagesForMdl
)
{...}

參數

[in] hAdapter

顯示配接器的句柄。

[in/out] pAllocatePagesForMdl

DXGKARGCB_ALLOCATEPAGESFORMDL 結構的指標,其中包含要配置 MDL 頁面的自變數。

傳回值

如果作業成功,則傳回STATUS_SUCCESS。 否則,傳回適當的NTSTATUS錯誤碼。

言論

此回呼函式是 Windows 圖形埠驅動程式函式,相當於 MmAllocatePagesForMdl 函式

DXGKCB_XXX 函式是由 Dxgkrnl實作。 若要使用此回呼函式,請設定適當的 DXGKARGCB_ALLOCATEPAGESFORMDL 成員,然後透過 DXGKRNL_INTERFACE呼叫 DxgkCbAllocatePagesForMdl

在分頁作業期間由 GPU 存取的所有記憶體,或透過 GpuMmu 對應的所有記憶體都必須對應至 IOMMU。 Dxgkrnl 提供內核模式驅動程式的回呼,以允許在一個步驟中配置和重新對應。

注意

DXGKCB_ALLOCATEPAGESFORMDL 的呼叫僅限於 4GB PAGE_SIZE MDL 限制,Dxgkrnl 一律會指定內部呼叫中 MM_ALLOCATE_FULLY_REQUIRED 旗標,MmAllocatePagesForMdlEx 函式。 驅動程式也不應該鎖定任何記憶體。 Dxgkrnl 將會管理驅動程式的鎖定頁面,而且一旦重新對應記憶體,提供給驅動程式的頁面邏輯位址可能不再符合實體位址。

如需詳細資訊,請參閱 IOMMU 型 GPU 隔離

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1803 (WDDM 2.4)
標頭 d3dkmddi.h
IRQL PASSIVE_LEVEL

另請參閱

DXGKARGCB_ALLOCATEPAGESFORMDL

DXGKCB_FREEPAGESFROMMDL

DXGKRNL_INTERFACE