structure DXGK_SEGMENTBANKPREFERENCE (d3dkmddi.h)

Article
02/23/2024

La structure DXGK_SEGMENTBANKPREFERENCE décrit les préférences bancaires pour la pagination dans une allocation.

Syntaxe

typedef struct _DXGK_SEGMENTBANKPREFERENCE {
  union {
    struct {
      UINT Bank0 : 7;
      UINT Direction0 : 1;
      UINT Bank1 : 7;
      UINT Direction1 : 1;
      UINT Bank2 : 7;
      UINT Direction2 : 1;
      UINT Bank3 : 7;
      UINT Direction3 : 1;
    };
    [out] UINT Value;
  };
} DXGK_SEGMENTBANKPREFERENCE;

Membres

[out] Bank0

Identificateur de la banque préférée la plus haute priorité, ou 0 si aucune préférence n’est requise. Les valeurs valides sont comprises entre 1 et 127.

Ce membre équivaut aux 7 premiers bits du membre Value 32 bits (0x0000007F).

[out] Direction0

Direction dans laquelle Bank0 doit être analysé pour localiser une zone libre de mémoire. La valeur 0 indique une recherche de bas en haut (c’est-à-dire une adresse faible à une adresse élevée), et la valeur 1 indique une recherche en bas (c’est-à-dire, adresse haute à adresse basse).

Ce membre équivaut au huitième bit du membre Value 32 bits (0x00000080).

[out] Bank1

Identificateur de la banque préférée la plus haute priorité suivante, ou 0 si aucune préférence n’est requise. Les valeurs valides sont comprises entre 1 et 127.

Ce membre équivaut aux bits 9 à 15 du membre Value 32 bits (0x00007F00).

[out] Direction1

Direction dans laquelle Bank1 doit être analysé pour localiser un trou libre de mémoire. La valeur 0 indique une recherche de bas en haut (c’est-à-dire une adresse faible à une adresse élevée), et la valeur 1 indique une recherche en bas (c’est-à-dire, adresse haute à adresse basse).

Ce membre équivaut au seizième bit du membre Value 32 bits (0x00008000).

[out] Bank2

Identificateur de la banque préférée la plus haute priorité suivante, ou 0 si aucune préférence n’est requise. Les valeurs valides sont comprises entre 1 et 127.

Ce membre équivaut aux bits 17 à 23 du membre Value 32 bits (0x007F0000).

[out] Direction2

Direction dans laquelle Bank2 doit être analysé pour localiser un trou libre de mémoire. La valeur 0 indique une recherche de bas en haut (c’est-à-dire une adresse faible à une adresse élevée), et la valeur 1 indique une recherche en bas (c’est-à-dire, adresse haute à adresse basse).

Ce membre équivaut au vingt-quatrième bit du membre Value 32 bits (0x00800000).

[out] Bank3

Identificateur de la banque préférée la plus haute priorité suivante, ou 0 si aucune préférence n’est requise. Les valeurs valides sont comprises entre 1 et 127.

Ce membre équivaut aux bits 25 à 31 du membre Value 32 bits (0x7F000000).

[out] Direction3

Direction dans laquelle Bank3 doit être analysé pour localiser un trou libre de mémoire. La valeur 0 indique une recherche de bas en haut (c’est-à-dire une adresse faible à une adresse élevée), et la valeur 1 indique une recherche en bas (c’est-à-dire, adresse haute à adresse basse).

Ce membre équivaut au trente-secondebit du membre Value 32 bits (0x80000000).

[out] Value

Membre de l’union que contient DXGK_SEGMENTBANKPREFERENCE peut contenir une valeur 32 bits qui identifie les préférences bancaires.

Remarques

Le pilote miniport d’affichage peut indiquer jusqu’à quatre préférences bancaires dans le membre HintedBank d’une structure DXGK_ALLOCATIONINFO lorsque la fonction DxgkDdiCreateAllocation du pilote est appelée. Les identificateurs de banque préférée sont basés sur un (c’est-à-dire que la première banque a un identificateur d’un). Un identificateur de zéro indique que le pilote n’a aucune préférence. La préférence de priorité la plus élevée est spécifiée dans le membre Bank0 ; la préférence de priorité la plus faible est spécifiée dans le membre Bank3 . Le pilote peut spécifier moins de quatre préférences en définissant les préférences de priorité inférieure des identificateurs bancaires sur zéro. Par exemple, le pilote peut spécifier deux préférences en définissant Bank0 et Bank1 sur des identificateurs valides et Bank2 et Bank3 sur zéro. Le pilote peut utiliser chaque membre DirectionX pour spécifier indépendamment le sens d’analyse de chaque préférence bancaire.

Le gestionnaire de mémoire vidéo alloue des ressources à partir des segments préférés que le membre PreferredSegment de DXGK_ALLOCATIONINFO spécifie.