DXGKCB_ALLOCATECONTIGUOUSMEMORY funzione di callback (d3dkmddi.h)

Articolo
02/26/2024

DXGKCB_ALLOCATECONTIGUOUSMEMORY alloca aree di memoria contigue nello spazio indirizzi logico di IOMMU.

Sintassi

DXGKCB_ALLOCATECONTIGUOUSMEMORY DxgkcbAllocatecontiguousmemory;

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

Parametri

[in] hAdapter

Handle per una scheda di visualizzazione.

[in/out] pAllocateContiguousMemory

Puntatore a una struttura DXGKARGCB_ALLOCATECONTIGUOUSMEMORY che contiene argomenti per allocare memoria contigua.

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituisce un codice di errore NTSTATUS appropriato.

Commenti

Questa funzione di callback è l'equivalente di Dxgkrnl alla funzione MmAllocateContiguousMemory.

DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, impostare i membri appropriati di DXGKARGCB_ALLOCATECONTIGUOUSMEMORY e quindi chiamare DxgkCbAllocateContiguousMemory tramite il DXGKRNL_INTERFACE.

È necessario eseguire il mapping di tutta la memoria a cui si accede dalla GPU durante le operazioni di paging o di cui è stato eseguito il mapping tramite GpuMmu all'IOMMU. Dxgkrnl fornisce callback al KMD per consentire l'allocazione e il mapping in un unico passaggio.

Nota

Il driver non deve bloccare alcuna memoria. Dxgkrnl gestirà le pagine bloccate per il driver e, dopo il mapping della memoria, l'indirizzo logico delle pagine fornite al driver potrebbe non corrispondere più agli indirizzi fisici.

Per altre informazioni, vedere Isolamento GPU basato su IOMMU .