DXGKCB_ALLOCATEPAGESFORMDL funzione di callback (d3dkmddi.h)

Articolo
08/07/2023

DXGKCB_ALLOCATEPAGESFORMDL alloca pagine di memoria fisica per un elenco di descrittori di memoria (MDL) di cui eseguire il mapping allo spazio indirizzi logico di IOMMU.

Sintassi

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

NTSTATUS DxgkcbAllocatepagesformdl(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_ALLOCATEPAGESFORMDL pAllocatePagesForMdl
)
{...}

Parametri

[in] hAdapter

Handle per l'adattatore di visualizzazione.

[in/out] pAllocatePagesForMdl

Puntatore a una struttura DXGKARGCB_ALLOCATEPAGESFORMDL che contiene argomenti per allocare pagine per MDL.

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 è una funzione driver porta grafica di Windows equivalente alla funzione MmAllocatePagesForMdl.

DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, impostare i membri appropriati di DXGKARGCB_ALLOCATEPAGESFORMDL e quindi chiamare DxgkCbAllocatePagesForMdl 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 driver in modalità kernel per consentire l'allocazione e il nuovo mapping in un unico passaggio.

Nota

Le chiamate a DXGKCB_ALLOCATEPAGESFORMDL sono limitate alla restrizione MDL PAGE_SIZE da 4 GB e Dxgkrnl specifica sempre il flag di MM_ALLOCATE_FULLY_REQUIRED nella chiamata interna alla funzione MmAllocatePagesForMdlEx. Inoltre, 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 .