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 |