estrutura DXGK_SEGMENTBANKPREFERENCE (d3dkmddi.h)

Artigo
05/26/2023

A estrutura DXGK_SEGMENTBANKPREFERENCE descreve as preferências bancárias para paginação em uma alocação.

Sintaxe

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;

Membros

[out] Bank0

O identificador do banco preferencial de prioridade mais alta ou 0 se nenhuma preferência for necessária. Os valores válidos são de 1 a 127.

Esse membro é equivalente aos primeiros 7 bits do membro Value de 32 bits (0x0000007F).

[out] Direction0

A direção na qual o Bank0 deve ser examinado para localizar uma área livre de memória. Um valor 0 indica uma pesquisa de baixo para cima (ou seja, endereço baixo para endereço alto) e um valor de 1 indica uma pesquisa de parte superior inferior (ou seja, endereço alto para endereço baixo).

Esse membro é equivalente ao oitavo bit do membro Value de 32 bits (0x00000080).

[out] Bank1

O identificador do próximo banco preferencial de prioridade mais alta ou 0 se nenhuma preferência for necessária. Os valores válidos são de 1 a 127.

Esse membro é equivalente aos bits de 9 a 15 do membro Value de 32 bits (0x00007F00).

[out] Direction1

A direção na qual o Bank1 deve ser verificado para localizar um buraco livre de memória. Um valor 0 indica uma pesquisa de baixo para cima (ou seja, endereço baixo para endereço alto) e um valor de 1 indica uma pesquisa de parte superior inferior (ou seja, endereço alto para endereço baixo).

Esse membro é equivalente ao décimo sexto bit do membro Value de 32 bits (0x00008000).

[out] Bank2

O identificador do próximo banco preferencial de prioridade mais alta ou 0 se nenhuma preferência for necessária. Os valores válidos são de 1 a 127.

Esse membro é equivalente aos bits de 17 a 23 do membro Value de 32 bits (0x007F0000).

[out] Direction2

A direção na qual o Bank2 deve ser verificado para localizar um buraco livre de memória. Um valor 0 indica uma pesquisa de baixo para cima (ou seja, endereço baixo para endereço alto) e um valor de 1 indica uma pesquisa de parte superior inferior (ou seja, endereço alto para endereço baixo).

Esse membro é equivalente ao vigésimo quarto bit do membro Value de 32 bits (0x00800000).

[out] Bank3

O identificador do próximo banco preferencial de prioridade mais alta ou 0 se nenhuma preferência for necessária. Os valores válidos são de 1 a 127.

Esse membro é equivalente aos bits de 25 a 31 do membro Value de 32 bits (0x7F000000).

[out] Direction3

A direção na qual o Bank3 deve ser verificado para localizar um buraco livre de memória. Um valor 0 indica uma pesquisa de baixo para cima (ou seja, endereço baixo para endereço alto) e um valor de 1 indica uma pesquisa de parte superior inferior (ou seja, endereço alto para endereço baixo).

Esse membro é equivalente ao bit de trinta segundos do membro Value de 32 bits (0x80000000).

[out] Value

Um membro do sindicato que DXGK_SEGMENTBANKPREFERENCE contém que pode conter um valor de 32 bits que identifica as preferências bancárias.

Comentários

O driver de miniporta de exibição pode indicar até quatro preferências bancárias no membro HintedBank de uma estrutura DXGK_ALLOCATIONINFO quando a função DxgkDdiCreateAllocation do driver é chamada. Identificadores de banco preferencial são baseados em um (ou seja, o primeiro banco tem um identificador de um). Um identificador de zero indica que o driver não tem preferência. A preferência de prioridade mais alta é especificada no membro do Bank0 ; a preferência de prioridade mais baixa é especificada no membro do Bank3 . O driver pode especificar menos de quatro preferências definindo as preferências de prioridade mais baixa dos identificadores bancários como zero. Por exemplo, o driver pode especificar duas preferências definindo Bank0 e Bank1 como identificadores válidos e Bank2 e Bank3 como zero. O driver pode usar cada membro directionX para especificar a direção de verificação para cada preferência bancária de forma independente.

O gerenciador de memória de vídeo aloca recursos de segmentos preferenciais que o membro PreferredSegment do DXGK_ALLOCATIONINFO especifica.