estructura DXGK_SEGMENTBANKPREFERENCE (d3dkmddi.h)

Artículo
03/08/2023

La estructura de DXGK_SEGMENTBANKPREFERENCE describe las preferencias bancarias para la paginación en una asignación.

Sintaxis

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;

Miembros

[out] Bank0

Identificador del banco preferido de prioridad más alta o 0 si no se requiere ninguna preferencia. Los valores válidos son de 1 a 127.

Este miembro es equivalente a los primeros 7 bits del miembro Value de 32 bits (0x0000007F).

[out] Direction0

Dirección en la que se debe examinar Bank0 para localizar un área libre de memoria. Un valor de 0 indica una búsqueda de abajo arriba (es decir, una dirección baja a una dirección alta) y un valor de 1 indica una búsqueda de arriba abajo (es decir, dirección alta a dirección baja).

Este miembro es equivalente al octavo bit del miembro Value de 32 bits (0x00000080).

[out] Bank1

Identificador del siguiente banco preferido de prioridad más alta o 0 si no se requiere ninguna preferencia. Los valores válidos son de 1 a 127.

Este miembro es equivalente a bits de 9 a 15 del miembro Value de 32 bits (0x00007F00).

[out] Direction1

Dirección en la que se debe examinar Bank1 para localizar un agujero libre de memoria. Un valor de 0 indica una búsqueda de abajo arriba (es decir, una dirección baja a una dirección alta) y un valor de 1 indica una búsqueda de arriba abajo (es decir, dirección alta a dirección baja).

Este miembro es equivalente al decimosexto bit del miembro Value de 32 bits (0x00008000).

[out] Bank2

Identificador del siguiente banco preferido de prioridad más alta o 0 si no se requiere ninguna preferencia. Los valores válidos son de 1 a 127.

Este miembro es equivalente a bits de 17 a 23 del miembro Value de 32 bits (0x007F0000).

[out] Direction2

Dirección en la que se debe examinar Bank2 para localizar un agujero libre de memoria. Un valor de 0 indica una búsqueda de abajo arriba (es decir, una dirección baja a una dirección alta) y un valor de 1 indica una búsqueda de arriba abajo (es decir, dirección alta a dirección baja).

Este miembro es equivalente al veinticuatro bits del miembro Value de 32 bits (0x00800000).

[out] Bank3

Identificador del siguiente banco preferido de prioridad más alta o 0 si no se requiere ninguna preferencia. Los valores válidos son de 1 a 127.

Este miembro es equivalente a bits de 25 a 31 del miembro Value de 32 bits (0x7F000000).

[out] Direction3

Dirección en la que se debe examinar Bank3 para localizar un agujero libre de memoria. Un valor de 0 indica una búsqueda de abajo arriba (es decir, una dirección baja a una dirección alta) y un valor de 1 indica una búsqueda de arriba abajo (es decir, dirección alta a dirección baja).

Este miembro es equivalente al treinta segundos del miembro Value de 32 bits (0x80000000).

[out] Value

Miembro de la unión que DXGK_SEGMENTBANKPREFERENCE contiene que puede contener un valor de 32 bits que identifica las preferencias bancarias.

Comentarios

El controlador de minipuerto de pantalla puede indicar hasta cuatro preferencias bancarias en el miembro HintedBank de una estructura de DXGK_ALLOCATIONINFO cuando se llama a la función DxgkDdiCreateAllocation del controlador. Los identificadores de banco preferidos se basan en uno (es decir, el primer banco tiene un identificador de uno). Un identificador de cero indica que el controlador no tiene ninguna preferencia. La preferencia de prioridad más alta se especifica en el miembro Bank0 ; la preferencia de prioridad más baja se especifica en el miembro Bank3 . El controlador puede especificar menos de cuatro preferencias estableciendo las preferencias de prioridad inferior de los identificadores bancarios en cero. Por ejemplo, el controlador puede especificar dos preferencias estableciendo Bank0 y Bank1 en identificadores válidos y Bank2 y Bank3 en cero. El controlador puede usar cada miembro DirectionX para especificar la dirección de exploración de cada preferencia bancaria de forma independiente.

El administrador de memoria de vídeo asigna recursos de segmentos preferidos que especifica el miembro PreferredSegment de DXGK_ALLOCATIONINFO.