DXGKCB_ALLOCATEPAGESFORMDL回呼函式 (d3dkmddi.h)

發行項
02/25/2024

DXGKCB_ALLOCATEPAGESFORMDL 為要對應至 IOMMU 邏輯地址空間的 MDL 描述元清單 (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。

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

注意

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

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