estructura DXGK_QUERYSEGMENTOUT3 (d3dkmddi.h)

Artículo
02/23/2024

Describe información de segmento de memoria que un controlador de controlador de pantalla de Windows (WDDM) 1.2 o posterior debe devolver de una llamada a su función DxgkDdiQueryAdapterInfo .

Sintaxis

typedef struct _DXGK_QUERYSEGMENTOUT3 {
  [out] UINT                    NbSegment;
  [out] DXGK_SEGMENTDESCRIPTOR3 *pSegmentDescriptor;
  [out] UINT                    PagingBufferSegmentId;
  [out] UINT                    PagingBufferSize;
  [out] UINT                    PagingBufferPrivateDataSize;
} DXGK_QUERYSEGMENTOUT3;

Miembros

[out] NbSegment

Número de segmentos de memoria que admite el controlador.

[out] pSegmentDescriptor

Matriz de estructuras de DXGK_SEGMENTDESCRIPTOR3 que el controlador rellena con información sobre los segmentos que admite. El tamaño de la matriz es el valor que NbSegment especifica.

[out] PagingBufferSegmentId

Identificador del segmento desde el que el administrador de memoria de vídeo debe asignar el búfer de paginación. Este segmento debe ser un segmento de apertura.

[out] PagingBufferSize

Tamaño, en bytes, que el administrador de memoria de vídeo debe asignar para el búfer de paginación.

[out] PagingBufferPrivateDataSize

Tamaño, en bytes, de la estructura de datos privada residente en el controlador que está asociada a cada búfer de paginación. La memoria de esta estructura de datos privada se asigna desde un grupo no paginado. Si el controlador especifica cero para PagingBufferPrivateDataSize, no se asigna memoria para la estructura de datos privada.

La estructura de datos privada asociada a un búfer de paginación se inicializa en cero cuando se crea el búfer de paginación. Durante la vigencia del búfer de paginación, el administrador de memoria de vídeo nunca accede a la estructura de datos privada asociada al búfer de paginación.

Comentarios

El controlador de miniporte de pantalla usa esta estructura para devolver información sobre los segmentos de memoria en respuesta a una llamada de función DxgkDdiQueryAdapterInfo en la que el subsistema de gráficos especifica el valor DXGKQAITYPE_QUERYSEGMENT3 en el miembro Type de la estructura DXGKARG_QUERYADAPTERINFO .

El administrador de memoria de vídeo asigna un búfer de paginación desde un segmento de apertura (si el miembro PagingBufferSegmentId identifica el segmento) o como un bloque de memoria combinado de escritura contiguo (si PagingBufferSegmentId está establecido en 0). Si PagingBufferSegmentId está establecido en 0, la GPU debe acceder a los búferes de acceso directo a memoria (DMA) mediante ciclos PCI en sistemas donde no se permiten las transferencias AGP que se producen fuera de la apertura de AGP.