estructura D3DKMDT_SHADOWSURFACEDATA (d3dkmdt.h)

Artículo
05/18/2024

La estructura D3DKMDT_SHADOWSURFACEDATA describe una superficie de sombras bloqueable, que coincide con la superficie principal en formato y resolución para un modo de visualización determinado.

Sintaxis

typedef struct _D3DKMDT_SHADOWSURFACEDATA {
  [in]  UINT         Width;
  [in]  UINT         Height;
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Pitch;
} D3DKMDT_SHADOWSURFACEDATA;

Miembros

[in] Width

Ancho de la superficie, en píxeles. El controlador devuelve el valor de ancho.

[in] Height

Alto de la superficie, en píxeles. El controlador devuelve el valor de alto.

[in] Format

Valor con tipo D3DDDIFORMAT que indica el formato de píxel de la superficie. El controlador devuelve el valor de formato.

[out] Pitch

Ancho de la superficie, en bytes. El controlador debe devolver el valor de inclinación porque la superficie de sombra es bloqueable.

Comentarios

El subsistema del kernel de gráficos de Microsoft DirectX pasa la estructura D3DKMDT_SHADOWSURFACEDATA en una llamada a la función DxgkDdiGetStandardAllocationDriverData del controlador de miniporte para mostrar para generar una descripción de una superficie de sombras bloqueable. El subsistema del kernel de gráficos de DirectX usa la descripción de una llamada a la función DxgkDdiCreateAllocation del controlador de miniporte para mostrar para crear la superficie de sombras bloqueable.

La CPU dibuja en la superficie de sombra bloqueada, desbloquea la superficie de sombras y, a continuación, emite solicitudes de transferencia de bloques de bits (bitblt) a través de la función DxgkDdiPresent desde la superficie de sombra hasta la superficie principal compartida coincidente. Las solicitudes de transferencia de bloques de bits también se emiten para transferir datos de una superficie principal compartida a la superficie de sombras.

No se requiere una operación de conversión de color, ajuste o reducción al copiar datos desde o a una superficie de sombra porque los formatos de origen y destino y las dimensiones de las superficies primarias compartidas y sombras siempre coinciden.