struttura DXGKARGCB_ALLOCATECONTIGUOUSMEMORY (d3dkmddi.h)

Articolo
02/06/2025

La struttura DXGKARGCB_ALLOCATECONTIGUOUSMEMORY contiene gli argomenti utilizzati nella funzione di callback DXGKCB_ALLOCATECONTIGUOUSMEMORY per allocare memoria contigua.

Sintassi

typedef struct _DXGKARGCB_ALLOCATECONTIGUOUSMEMORY {
  [in]  SIZE_T                   NumberOfBytes;
  [in]  PHYSICAL_ADDRESS         LowestAcceptableAddress;
  [in]  PHYSICAL_ADDRESS         HighestAcceptableAddress;
  [in]  PHYSICAL_ADDRESS         BoundaryAddressMultiple;
  [in]  DXGK_MEMORY_CACHING_TYPE CacheType;
  [out] HANDLE                   hMemoryHandle;
  [out] PVOID                    pMemory;
} DXGKARGCB_ALLOCATECONTIGUOUSMEMORY;

Membri

[in] NumberOfBytes

Dimensione, in byte, del blocco di memoria contigua da allocare.

[in] LowestAcceptableAddress

Indirizzo fisico più basso valido che il chiamante può usare. Ad esempio, se un dispositivo può gestire solo posizioni superiori ai primi 8 megabyte dell'intervallo di indirizzi di memoria fisica del processore, il driver per questo dispositivo deve impostare LowestAcceptableAddress su 0x0000000000800000.

[in] HighestAcceptableAddress

L'indirizzo fisico più alto valido che il chiamante può usare. Ad esempio, se un dispositivo può indirizzare solo le posizioni nei primi 16 megabyte dell'intervallo di indirizzi di memoria fisica del processore, il driver per questo dispositivo deve impostare HighestAcceptableAddress su 0x0000000000FFFFFF.

[in] BoundaryAddressMultiple

Indirizzo fisico multiplo che il buffer allocato non deve attraversare. Un indirizzo fisico multiplo deve essere sempre una potenza di due. Questo parametro è facoltativo e può essere specificato come zero per indicare che il dispositivo non ha restrizioni speciali per il limite di memoria.

[in] CacheType

Valore DXGK_MEMORY_CACHING_TYPE che specifica il tipo di cache delle pagine da allocare.

[out] hMemoryHandle

Un Dxgkrnl handle di rilevamento per l'allocazione. Questo valore deve essere passato alla funzione di callback DGXKCB_FREECONTIGUOUSMEMORY corrispondente.

[out] pMemory

È garantito il mapping di un blocco contiguo di memoria fisica non di paging all'IOMMU per la sua durata.

Osservazioni

Per altre informazioni, vedere isolamento GPU basato su IOMMU.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1803 (WDDM 2.4)
intestazione	d3dkmddi.h

Vedere anche

DXGKCB_ALLOCATECONTIGUOUSMEMORY

Condividi tramite