DXGKCB_ALLOCATEADL funzione di callback (d3dkmddi.h)

  • Articolo

DXGKCB_ALLOCATEADL crea un elenco di descrittori di indirizzi (ADL).

Sintassi

DXGKCB_ALLOCATEADL DxgkcbAllocateadl;

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

Parametri

[in/out] pArgs

Puntatore a una struttura DXGKARGCB_ALLOCATE_ADL contenente informazioni sull'ADL da creare. In caso di esito positivo, restituisce una struttura DXGK_ADL con un elenco di indirizzi di pagina che possono essere usati per programmare l'hardware.

Valore restituito

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

Commenti

Le funzioni DXGKCB_ALLOCATEADL e DXGKCB_FREEADL vengono usate per creare ed eliminare le adcl che descrivono gli indirizzi di memoria che possono essere programmati (mappati) alla GPU. La memoria sottostante può puntare alla memoria logica o fisica a seconda che venga usata l'IOMMU, quindi il driver non deve tentare di presupporre che questi indirizzi rappresentino pagine fisiche.

Quando un ADL viene allocato dall'oggetto fisico, Dxgkrnl garantisce che la memoria rimanga bloccata ed è non paging per la durata di ADL.

Per altre informazioni, vedere Il mapping DMA di IOMMU .

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

Requisiti

Requisito Valore
Server minimo supportato Windows Server 2022 (WDDM 2.9)
Intestazione d3dkmddi.h
IRQL PASSIVE_LEVEL

Vedi anche

DXGKARGCB_ALLOCATE_ADL

DXGKCB_FREEADL

DXGKRNL_INTERFACE