structure DXGKARGCB_ALLOCATECONTIGUOUSMEMORY (d3dkmddi.h)

Article
02/26/2024

La structure DXGKARGCB_ALLOCATECONTIGUOUSMEMORY contient les arguments utilisés dans la fonction de rappel DXGKCB_ALLOCATECONTIGUOUSMEMORY , pour allouer de la mémoire contiguë.

Syntaxe

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;

Membres

[in] NumberOfBytes

Taille, en octets, du bloc de mémoire contiguë à allouer.

[in] LowestAcceptableAddress

Adresse physique valide la plus basse que l’appelant peut utiliser. Par exemple, si un appareil peut traiter uniquement les emplacements au-dessus des 8 premiers mégaoctets de la plage d’adresses de mémoire physique du processeur, le pilote de cet appareil doit définir LowestAcceptableAddress sur 0x0000000000800000.

[in] HighestAcceptableAddress

Adresse physique valide la plus élevée que l’appelant peut utiliser. Par exemple, si un appareil peut traiter uniquement les emplacements dans les 16 premiers mégaoctets de la plage d’adresses de mémoire physique du processeur, le pilote de cet appareil doit définir l’adresse la plus élevée inacceptable sur 0x0000000000FFFFFF.

[in] BoundaryAddressMultiple

Adresse physique multiple que la mémoire tampon allouée ne doit pas croiser. Un multiple d’adresses physiques doit toujours être une puissance de deux. Ce paramètre est facultatif et peut être spécifié comme zéro pour indiquer que l’appareil n’a pas de restrictions de limites de mémoire spéciales.

[in] CacheType

Valeur DXGK_MEMORY_CACHING_TYPE qui spécifie le type de cache des pages à allouer.

[out] hMemoryHandle

Un handle de suivi Dxgkrnl pour l’allocation. Cette valeur doit être passée à la fonction de rappel DGXKCB_FREECONTIGUOUSMEMORY correspondante.

[out] pMemory

Une partie contiguë de la mémoire physique non paginée garantie pour être mappée à l’IOMMU pendant sa durée de vie.

Remarques

Pour plus d’informations, consultez Isolation GPU basée sur IOMMU .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1803 (WDDM 2.4)
En-tête	d3dkmddi.h

Voir aussi

DXGKCB_ALLOCATECONTIGUOUSMEMORY

Partager via