structure DXGK_SEGMENTFLAGS (d3dkmddi.h)

Article
02/06/2025

La structure DXGK_SEGMENTFLAGS identifie les propriétés d’un segment fourni par le pilote via un appel à sa fonction DxgkDdiQueryAdapterInfo.

Syntaxe

typedef struct _DXGK_SEGMENTFLAGS {
  union {
    struct {
      UINT Aperture : 1;
      UINT Agp : 1;
      UINT CpuVisible : 1;
      UINT UseBanking : 1;
      UINT CacheCoherent : 1;
      UINT PitchAlignment : 1;
      UINT PopulatedFromSystemMemory : 1;
      UINT PreservedDuringStandby : 1;
      UINT PreservedDuringHibernate : 1;
      UINT PartiallyPreservedDuringHibernate : 1;
      UINT DirectFlip : 1;
      UINT Use64KBPages : 1;
      UINT ReservedSysMem : 1;
      UINT SupportsCpuHostAperture : 1;
      UINT SupportsCachedCpuHostAperture : 1;
      UINT ApplicationTarget : 1;
      UINT VprSupported : 1;
      UINT VprPreservedDuringStandby : 1;
      UINT EncryptedPagingSupported : 1;
      UINT LocalBudgetGroup : 1;
      UINT NonLocalBudgetGroup : 1;
      UINT PopulatedByReservedDDRByFirmware : 1;
#if ...
      UINT Reserved : 10;
#elif
      UINT Reserved : 11;
#elif
      UINT Reserved : 21;
#else
      UINT Reserved : 22;
#endif
    };
    UINT Value;
  };
} DXGK_SEGMENTFLAGS;

Membres

Aperture

[out] Valeur UINT qui spécifie si le segment est un segment d’ouverture au lieu d’un segment de mémoire. Un segment d’ouverture n’a pas de pages physiques qui peuvent contenir du contenu pour une allocation. Lorsque le gestionnaire de mémoire vidéo pages une allocation dans un segment de mémoire, le gestionnaire de mémoire transfère le contenu de l’allocation du magasin de stockage de mémoire système à l’emplacement du segment. Lorsque le gestionnaire de mémoire vidéo pages une allocation dans un segment d’ouverture, le gestionnaire de mémoire mappe les pages physiques du magasin de stockage d’allocation dans le segment.

Si le pilote spécifie ce membre, il doit également implémenter les types d’opération map-aperture-segment et unmap-aperture-segment pour son DxgkDdiBuildPagingBuffer fonction.

La définition de ce membre équivaut à définir le premier bit du membre valeur de 32 bits (0x00000001).

Agp

[out] Valeur UINT qui spécifie si le segment est un segment AGP**-type d’ouverture, qui utilise une partie de l’ouverture AGP exposée par le microprogramme. Le gestionnaire de mémoire vidéo alloue la page pour l’ouverture sous-jacente et communique avec le pilote de table de remapping d’adresses graphiques (GART) pour mapper et annuler le mappage de la mémoire pour l’ouverture. Étant donné qu’il n’existe qu’un seul segment AGP, le pilote ne doit pas spécifier l’indicateur de champ binaire avec d’autres indicateurs de champ binaire DXGK_SEGMENTFLAGS.

La définition de ce membre équivaut à définir le deuxième bit du membre valeur 32 bits (0x00000002).

CpuVisible

[out] Valeur UINT qui spécifie si le segment de mémoire est accessible au processeur à l’adresse spécifiée par le membre CpuTranslatedAddress de la structure DXGK_SEGMENTDESCRIPTOR qui décrit le segment de mémoire.

Ce membre n’a aucune signification pour un segment d’ouverture, y compris le segment d’ouverture de type AGP. La seule exception se produit lorsque le pilote d’affichage en mode utilisateur n’a pas configuré une autre adresse virtuelle pour une allocation principale (autrement dit, lorsque le pilote n’a pas défini UseAlternateVA dans les indicateurs membre de la structure D3DDDICB_LOCKFLAGS lors d’un appel à la fonction pfnLockCb).

Pour plus d’informations, consultez les remarques.

La définition de ce membre équivaut à définir le troisième bit du membre valeur 32 bits (0x00000004).

UseBanking

[out] Valeur UINT qui spécifie si le segment est divisé en banques que le pilote utilise pour fournir des conseils au gestionnaire de mémoire vidéo sur le placement des allocations au sein du segment. Le pilote doit également spécifier des informations bancaires valides dans le NbOfBanks et pBankRangeTable membres de la structure DXGK_SEGMENTDESCRIPTOR qui décrit le segment.

La définition de ce membre équivaut à définir le quatrième bit du membre valeur 32 bits (0x00000008).

CacheCoherent

[out] Valeur UINT qui spécifie si le segment d’ouverture peut conserver la cohérence du cache avec les pages pouvant être mappées dans l’ouverture. Ce membre ne peut être défini qu’avec la définition du membre Aperture (autrement dit, CacheCoherent n’a aucune signification pour un segment de mémoire).

La définition de ce membre équivaut à définir le cinquième bit du membre valeur 32 bits membre (0x00000010).

PitchAlignment

[out] Valeur UINT qui spécifie si une allocation mappée au segment doit être alignée. Pour ce type de segment, le gestionnaire de mémoire vidéo utilise le membre Size de la structure DXGK_ALLOCATIONINFO pour l’allocation afin d’allouer un magasin de stockage pour l’allocation. Toutefois, le gestionnaire de mémoire vidéo utilise le PitchAlignedSize membre de DXGK_ALLOCATIONINFO pour allouer des ressources pour le segment. Une allocation ciblée pour ce type de segment a généralement une taille différente pour le magasin de stockage et pour le segment. Lorsque la taille du magasin de stockage ne correspond pas à la taille du segment, le pilote doit déterminer comment déplacer correctement les données dans l’allocation. Ce type de segment ne peut pas être utilisé pour l’éviction.

La définition de ce membre équivaut à définir le sixième bit du membre valeur de 32 bits (0x00000020).

PopulatedFromSystemMemory

[out] Valeur UINT qui spécifie si le segment de mémoire est réellement rempli à partir de la mémoire système allouée par le pilote lors de l’initialisation. Si le segment de mémoire est rempli à partir de la mémoire système réservée par le BIOS et n’est pas accessible au système d’exploitation (autrement dit, le système d’exploitation ne compte pas cette mémoire système lorsque le système d’exploitation signale la quantité totale de mémoire système), le pilote ne doit pas définir cet indicateur. Cet indicateur n’est pas valide et est ignoré sur les segments d’ouverture.

La définition de ce membre équivaut à définir le septième bit du membre valeur 32 bits (0x00000040).

PreservedDuringStandby

[out] Valeur UINT qui spécifie si le segment est conservé dans une transition vers un état d’alimentation du système de secours.

Pour plus d’informations sur les options de transition d’alimentation, consultez Remarques.

La définition de ce membre équivaut à définir le huitième bit du membre valeur 32 bits (0x00000080).

Prise en charge à partir de Windows 8.

PreservedDuringHibernate

[out] Valeur UINT qui spécifie si le segment est conservé dans une transition vers un état d’alimentation du système en veille prolongée. Ne définissez pas cet indicateur, sauf si le membre PreservedDuringStandby est également défini. Pour plus d’informations sur les options de transition d’alimentation, consultez Remarques.

La définition de ce membre équivaut à définir le neuvième bit du membre valeur 32 bits membre (0x00000100).

Prise en charge à partir de Windows 8.

PartiallyPreservedDuringHibernate

[out] Valeur UINT qui spécifie si le segment est partiellement conservé dans une transition vers un état d’alimentation du système en veille prolongée. Ne définissez pas cet indicateur, sauf si le membre PreservedDuringStandby est également défini. Pour plus d’informations sur les options de transition d’alimentation, consultez Remarques.

La définition de ce membre équivaut à définir le dixième bit du membre valeur 32 bits (0x00000200).

Prise en charge à partir de Windows 8.

DirectFlip

[out] Valeur UINT qui spécifie si un segment prend en charge les allocations Direct Flip. Dans ce cas, le pilote doit s’assurer que les allocations Direct Flip peuvent être épinglées et analysées à partir de ce segment.

La définition de ce membre équivaut à définir le onzee bit du membre valeur 32 bits (0x00000400).

Prise en charge à partir de Windows 8.

Use64KBPages

[out] Quand il est défini, le segment de mémoire GPU prend en charge 64 Ko de pages. Sinon, 4 pages de Ko sont prises en charge. Lorsque le pilote définit la limite et qu’une allocation peut être paginée sur le segment, l’alignement de l’allocation, retourné par le pilote en mode noyau de DXGK_ALLOCATIONINFO, doit être multiple de 64 Ko.