DXGK_QUERYSEGMENTOUT3 structure (d3dkmddi.h)

Décrit les informations de segment de mémoire qu’un pilote d’affichage windows WDDM (Windows Display Driver Model) 1.2 ou version ultérieure doit retourner à partir d’un appel à sa fonction DxgkDdiQueryAdapterInfo .

Syntaxe

typedef struct _DXGK_QUERYSEGMENTOUT3 {
  [out] UINT                    NbSegment;
  [out] DXGK_SEGMENTDESCRIPTOR3 *pSegmentDescriptor;
  [out] UINT                    PagingBufferSegmentId;
  [out] UINT                    PagingBufferSize;
  [out] UINT                    PagingBufferPrivateDataSize;
} DXGK_QUERYSEGMENTOUT3;

Membres

[out] NbSegment

Nombre de segments de mémoire pris en charge par le pilote.

[out] pSegmentDescriptor

Tableau de structures DXGK_SEGMENTDESCRIPTOR3 que le pilote remplit avec des informations sur les segments qu’il prend en charge. La taille du tableau est la valeur spécifiée par NbSegment .

[out] PagingBufferSegmentId

Identificateur du segment à partir duquel le gestionnaire de mémoire vidéo doit allouer la mémoire tampon de pagination. Ce segment doit être un segment d’ouverture.

[out] PagingBufferSize

Taille, en octets, que le gestionnaire de mémoire vidéo doit allouer pour la mémoire tampon de pagination.

[out] PagingBufferPrivateDataSize

Taille, en octets, de la structure de données privées résidente du pilote associée à chaque mémoire tampon de pagination. La mémoire de cette structure de données privée est allouée à partir d’un pool non paginé. Si le pilote spécifie zéro pour PagingBufferPrivateDataSize, aucune mémoire n’est allouée à la structure de données privée.

La structure de données privées associée à une mémoire tampon de pagination est initialisée à zéro lors de la création de la mémoire tampon de pagination. Pendant la durée de vie de la mémoire tampon de pagination, le gestionnaire de mémoire vidéo n’accède jamais à la structure de données privée associée à la mémoire tampon de pagination.

Remarques

Cette structure est utilisée par le pilote de miniport d’affichage 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_QUERYSEGMENT3 dans le membre Type de la structure DXGKARG_QUERYADAPTERINFO .

Le gestionnaire de mémoire vidéo alloue une mémoire tampon de pagination à partir d’un segment d’ouverture (si le membre PagingBufferSegmentId identifie le segment) ou en tant que bloc de mémoire contiguë en écriture combinée (si PagingBufferSegmentId a la valeur 0). Si PagingBufferSegmentId est défini sur 0, le GPU doit accéder aux mémoires tampons d’accès direct à la mémoire (DMA) à l’aide de cycles PCI sur les systèmes où les transferts AGP qui se produisent en dehors de l’ouverture AGP ne sont pas autorisés.

Configuration requise

Voir aussi

DXGKARG_QUERYADAPTERINFO

DXGK_QUERYSEGMENTIN

DXGK_SEGMENTDESCRIPTOR3

DxgkDdiQueryAdapterInfo