DXGKCB_ALLOCATEADL回呼函式 (d3dkmddi.h)

DXGKCB_ALLOCATEADL 會在ADL) (建立位址描述元清單。

語法

DXGKCB_ALLOCATEADL DxgkcbAllocateadl;

NTSTATUS DxgkcbAllocateadl(
  [in/out] IN_OUT_PDXGKARGCB_ALLOCATE_ADL pArgs
)
{...}

[in/out] pArgs

包含要建立之 ADL 相關信息 的DXGKARGCB_ALLOCATE_ADL 結構的指標。成功時，傳回 DXGK_ADL 結構，其中包含可用來設計硬體的頁面位址清單。

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

DXGKCB_ALLOCATEADL和DXGKCB_FREEADL函式是用來建立和終結 ADL，描述可 (對應至 GPU) 的記憶體位址。基礎記憶體可以根據所使用的 IOMMU 是否指向邏輯或實體記憶體，因此驅動程式不得嘗試假設這些位址代表實體頁面。

當 ADL 從實體物件配置時， Dxgkrnl 會保證此記憶體會保持鎖定狀態，而且在 ADL 的存留期內無法分頁。

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