estructura DXGK_SEGMENTBANKPREFERENCE (d3dkmddi.h)

Artículo
02/06/2025

La estructura 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 van de 1 a 127.

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

[out] Direction0

Dirección en la que Bank0 debe examinarse para localizar un área libre de memoria. Un valor de 0 indica una búsqueda de abajo arriba (es decir, dirección baja a 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 van de 1 a 127.

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

[out] Direction1

Dirección en la que Bank1 debe examinarse para localizar un agujero libre de memoria. Un valor de 0 indica una búsqueda de abajo arriba (es decir, dirección baja a 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 van de 1 a 127.

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

[out] Direction2

Dirección en la que Bank2 debe examinarse para localizar un agujero libre de memoria. Un valor de 0 indica una búsqueda de abajo arriba (es decir, dirección baja a 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 miembro de 32 bits Value (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 van de 1 a 127.

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

[out] Direction3

Dirección en la que Bank3 debe examinarse para localizar un agujero libre de memoria. Un valor de 0 indica una búsqueda de abajo arriba (es decir, dirección baja a 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 y segundo bits del miembro de 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.

Observaciones

El controlador de miniporte 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 dxgkDdiCreateAlloc ation 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 examen de cada preferencia bancaria de forma independiente.

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