struttura DXGK_SEGMENTBANKPREFERENCE (d3dkmddi.h)

Articolo
05/26/2023

La struttura DXGK_SEGMENTBANKPREFERENCE descrive le preferenze bancarie per il paging in un'allocazione.

Sintassi

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;

Members

[out] Bank0

Identificatore della banca preferita con priorità più alta oppure 0 se non è richiesta alcuna preferenza. I valori validi sono compresi tra 1 e 127.

Questo membro equivale ai primi 7 bit del membro Value a 32 bit (0x0000007F).

[out] Direction0

Direzione in cui bank0 deve essere analizzato per individuare un'area libera di memoria. Il valore 0 indica una ricerca in basso verso l'alto (ovvero un indirizzo basso a un indirizzo elevato) e un valore pari a 1 indica una ricerca in alto verso il basso, ovvero un indirizzo alto a un indirizzo basso.

Questo membro equivale all'ottavo bit del membro Value a 32 bit (0x00000080).

[out] Bank1

Identificatore della banca preferita con priorità più alta successiva oppure 0 se non è richiesta alcuna preferenza. I valori validi sono compresi tra 1 e 127.

Questo membro equivale ai bit da 9 a 15 del membro Value a 32 bit (0x00007F00).

[out] Direction1

Direzione in cui deve essere analizzato Bank1 per individuare un buco libero di memoria. Il valore 0 indica una ricerca in basso verso l'alto (ovvero un indirizzo basso a un indirizzo elevato) e un valore pari a 1 indica una ricerca in alto verso il basso, ovvero un indirizzo alto a un indirizzo basso.

Questo membro equivale al sedicesimo bit del membro Value a 32 bit (0x00008000).

[out] Bank2

Identificatore della banca preferita con priorità più alta successiva oppure 0 se non è richiesta alcuna preferenza. I valori validi sono compresi tra 1 e 127.

Questo membro equivale ai bit da 17 a 23 del membro Value a 32 bit (0x007F0000).

[out] Direction2

Direzione in cui deve essere analizzata Bank2 per individuare un buco libero di memoria. Il valore 0 indica una ricerca in basso verso l'alto (ovvero un indirizzo basso a un indirizzo elevato) e un valore pari a 1 indica una ricerca in alto verso il basso, ovvero un indirizzo alto a un indirizzo basso.

Questo membro equivale al ventiquattro bit del membro Value a 32 bit (0x00800000).

[out] Bank3

Identificatore della banca preferita con priorità più alta successiva oppure 0 se non è richiesta alcuna preferenza. I valori validi sono compresi tra 1 e 127.

Questo membro equivale ai bit da 25 a 31 del membro Value a 32 bit (0x7F000000).

[out] Direction3

Direzione in cui bank3 deve essere analizzato per individuare un buco libero di memoria. Il valore 0 indica una ricerca in basso verso l'alto (ovvero un indirizzo basso a un indirizzo elevato) e un valore pari a 1 indica una ricerca in alto verso il basso, ovvero un indirizzo alto a un indirizzo basso.

Questo membro equivale al trentasei secondi del membro Value a 32 bit (0x80000000).

[out] Value

Membro dell'unione che DXGK_SEGMENTBANKPREFERENCE contiene che può contenere un valore a 32 bit che identifica le preferenze bancarie.

Commenti

Il driver miniport di visualizzazione può indicare fino a quattro preferenze bancarie nel membro HintedBank di una struttura DXGK_ALLOCATIONINFO quando viene chiamata la funzione DxgkDdiCreateAllocation del driver. Gli identificatori di banca preferita sono basati su una sola (ovvero la prima banca ha un identificatore di uno). Un identificatore pari a zero indica che il driver non ha alcuna preferenza. La preferenza di priorità più alta è specificata nel membro Bank0 ; la preferenza di priorità più bassa è specificata nel membro Bank3 . Il driver può specificare meno di quattro preferenze impostando le preferenze di priorità inferiore degli identificatori bancari su zero. Ad esempio, il driver può specificare due preferenze impostando Bank0 e Bank1 su identificatori validi e Bank2 e Bank3 su zero. Il driver può utilizzare ogni membro DirectionX per specificare la direzione di scansione per ogni preferenza della banca in modo indipendente.

Gestione memoria video alloca le risorse dai segmenti preferiti specificati dal membro PreferredSegment di DXGK_ALLOCATIONINFO.