DXGK_SEGMENTDESCRIPTOR4 structure (d3dkmddi.h)

  • Article

La structure DXGK_SEGMENTDESCRIPTOR4 décrit une ouverture d’hôte de processeur programmable.

Syntaxe

typedef struct _DXGK_SEGMENTDESCRIPTOR4 {
  DXGK_SEGMENTFLAGS Flags;
  PHYSICAL_ADDRESS  BaseAddress;
  SIZE_T            Size;
  SIZE_T            CommitLimit;
  SIZE_T            SystemMemoryEndAddress;
  union {
    PHYSICAL_ADDRESS     CpuTranslatedAddress;
    DXGK_CPUHOSTAPERTURE CpuHostAperture;
  };
  UINT              NumInvalidMemoryRanges;
  SIZE_T            VprRangeStartOffset;
  SIZE_T            VprRangeSize;
  UINT              VprAlignment;
  UINT              NumVprSupported;
  UINT              VprReserveSize;
  UINT              NumUEFIFrameBufferRanges;
} DXGK_SEGMENTDESCRIPTOR4;

Membres

Flags

Indicateurs de champ de bits de segment

BaseAddress

Adresse de base physique du segment dans le GPU.

Size

Taille du segment en octets.

CommitLimit

Nombre maximal d’octets pouvant être validés dans ce segment. Cette valeur s’applique uniquement au segment d’ouverture.

SystemMemoryEndAddress

Pour les segments partiellement composés de mémoire système, toutes les allocations se terminant après cette adresse sont purgées pendant la mise en veille prolongée.

CpuTranslatedAddress

Si Flags.SupportsCpuHostAperture==FALSE et que le segment est visible par le processeur, il s’agit de l’adresse de base physique du processeur du segment.

CpuHostAperture

Si Flags.SupportsCpuHostAperture==TRUE, il aura l’adresse du processeur et la taille de CPUHostAperture.

NumInvalidMemoryRanges

Nombre de plages de mémoire non valides dans le segment. Si cette valeur n’est pas égale à zéro, le pilote en mode noyau est appelé avec DdiQueryAdapterInfo(DXGKQAITYPE_SEGMENTMEMORYSTATE) pour obtenir des informations sur les plages de mémoire non valides.

VprRangeStartOffset

Début du décalage de la plage de régions protégées vidéo, en octets.

VprRangeSize

Taille de la plage de régions protégées vidéo, en octets.

VprAlignment

Alignement de la plage de régions protégées vidéo, en octets. Cette valeur s’applique à la taille et au décalage de début de la plage de régions protégées vidéo.

NumVprSupported

Nombre de plages vidéo protégées prises en charge dans la plage VPR. La valeur zéro indique la prise en charge d’un nombre infini.

VprReserveSize

Taille de la zone de la plage VPR réservée au pilote/matériel à utiliser, en octets. La valeur zéro indique qu’il n’y a pas de réserve.

NumUEFIFrameBufferRanges

Nombre de plages de mémoires tampons de trame UEFI dans le segment. Pris en charge à partir de WDDM 2.2.

Remarques

Cette structure est utilisée par un miniport d’affichage wdDM 2.0 ou ultérieur en mode noyau pour retourner des informations sur les segments de mémoire en réponse à un appel de fonction DxgkDdiQueryAdapterInfo dans lequel le sous-système graphique spécifie la valeur DXGKQAITYPE_QUERYSEGMENT4 dans le membre Type de la structure DXGKARG_QUERYADAPTERINFO .

Cette structure est pointée par le membre pSegmentDescriptor de la structure DXGK_QUERYSEGMENTOUT4 .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 (WDDM 2.0)
Serveur minimal pris en charge Windows Server 2016
En-tête d3dkmddi.h (include D3dkmddi.h)

Voir aussi

DXGK_QUERYSEGMENTOUT4

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo