DXGKCB_ALLOCATEADL回呼函式（d3dkmddi.h）

DXGKCB_ALLOCATEADL 建立位址描述元清單（ADL）。

語法

DXGKCB_ALLOCATEADL DxgkcbAllocateadl;

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

[in/out] pArgs

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

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

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

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

如需詳細資訊，請參閱 IOMMU DMA 重新對應。

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