DXGKCB_ALLOCATECONTIGUOUSMEMORY回呼函式 (d3dkmddi.h)

發行項
02/25/2024

DXGKCB_ALLOCATECONTIGUOUSMEMORY 會在IOMMU的邏輯位址空間中配置連續記憶體區域。

語法

DXGKCB_ALLOCATECONTIGUOUSMEMORY DxgkcbAllocatecontiguousmemory;

NTSTATUS DxgkcbAllocatecontiguousmemory(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_ALLOCATECONTIGUOUSMEMORY pAllocateContiguousMemory
)
{...}

參數

[in] hAdapter

顯示配接器的句柄。

[in/out] pAllocateContiguousMemory

DXGKARGCB_ALLOCATECONTIGUOUSMEMORY 結構的指標，其中包含要配置連續記憶體的自變數。

傳回值

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

備註

這個回呼函 式相當於MmAllocateContiguousMemory 函式。

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

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

注意

驅動程式不應該鎖定任何記憶體。 Dxgkrnl 會管理驅動程式的鎖定頁面，一旦重新對應記憶體，提供給驅動程式的頁面邏輯位址可能不再符合實體位址。

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