estructura D3DKMDT_STAGINGSURFACEDATA (d3dkmdt.h)

Artículo
05/18/2024

La estructura D3DKMDT_STAGINGSURFACEDATA describe la superficie de almacenamiento provisional bloqueable a la que se transfieren los datos desde el búfer de reserva de una aplicación.

Sintaxis

typedef struct _D3DKMDT_STAGINGSURFACEDATA {
  [in]  UINT Width;
  [in]  UINT Height;
  [out] UINT Pitch;
} D3DKMDT_STAGINGSURFACEDATA;

Miembros

[in] Width

Ancho del búfer de almacenamiento provisional, en píxeles.

[in] Height

Alto del búfer de almacenamiento provisional, en píxeles.

[out] Pitch

Ancho del búfer de almacenamiento provisional, en bytes. El controlador debe devolver el valor de tono porque el búfer de almacenamiento provisional es bloqueable.

Comentarios

La estructura de D3DKMDT_STAGINGSURFACEDATA se pasa mediante el subsistema del kernel de gráficos de Microsoft DirectX en una llamada a la función DxgkDdiGetStandardAllocationDriverData del controlador de miniporte de pantalla para generar una descripción de una superficie de ensayo bloqueable. El subsistema de gráficos llama a la función DxgkDdiPresent del controlador de miniporte de pantalla para emitir solicitudes de transferencia de bloques de bits (bitblt) para transferir datos desde el búfer de reserva de una aplicación a la superficie de ensayo. A continuación, la CPU bloquea y lee la superficie de ensayo.

Una superficie de almacenamiento provisional se crea potencialmente para la operación actual cuando no es posible transferir un bloque de bits directo a la superficie principal (por ejemplo, en casos de varios monitores o sprites).

Esta superficie de ensayo siempre se crea como un formato de píxel RGB de 8 bits por color (especificado por el valor D3DDDIFMT_X8R8G8B8 de la enumeración D3DDDIFORMAT ). Dado que las dimensiones de la superficie de ensayo siempre coinciden con las dimensiones del búfer de reserva, no se requiere ninguna operación de ajuste o reducción para la operación actual en la superficie de ensayo.