estrutura D3DKMDT_SHADOWSURFACEDATA (d3dkmdt.h)

Artigo
02/23/2024

A estrutura D3DKMDT_SHADOWSURFACEDATA descreve uma superfície de sombra bloqueável, que corresponde à superfície primária em formato e resolução para um determinado modo de exibição.

Sintaxe

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

Membros

[in] Width

A largura da superfície, em pixels. O driver retorna o valor de largura.

[in] Height

A altura da superfície, em pixels. O driver retorna o valor de altura.

[in] Format

Um valor de tipo D3DDDIFORMAT que indica o formato de pixel da superfície. O driver retorna o valor de formato.

[out] Pitch

A largura da superfície, em bytes. O driver deve retornar o valor de inclinação porque a superfície de sombra é bloqueável.

Comentários

A estrutura D3DKMDT_SHADOWSURFACEDATA é passada pelo subsistema de kernel de elementos gráficos do Microsoft DirectX em uma chamada para a função DxgkDdiGetStandardAllocationDriverData do driver de miniporta de exibição para gerar uma descrição de uma superfície de sombra bloqueável. O subsistema de kernel de elementos gráficos DirectX usa a descrição em uma chamada para a função DxgkDdiCreateAllocation do driver de miniporta de exibição para criar a superfície de sombra bloqueável.

A CPU desenha na superfície de sombra bloqueada, desbloqueia a superfície de sombra e, em seguida, emite solicitações de transferência de bloco de bits (bitblt) por meio da função DxgkDdiPresent da superfície de sombra para a superfície primária compartilhada correspondente. Solicitações de transferência de bloco de bits também são emitidas para transferir dados de uma superfície primária compartilhada para a superfície de sombra.

Uma operação de conversão, alongamento ou redução de cores não é necessária ao copiar dados de ou para uma superfície de sombra porque os formatos de origem e destino e dimensões de sombra e superfícies primárias compartilhadas sempre correspondem.