estrutura D3DKMDT_STAGINGSURFACEDATA (d3dkmdt.h)

Artigo
02/06/2025

A estrutura D3DKMDT_STAGINGSURFACEDATA descreve a superfície de preparo bloqueável para a qual os dados são transferidos do buffer de fundo de um aplicativo.

Sintaxe

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

Membros

[in] Width

A largura do buffer de preparo, em pixels.

[in] Height

A altura do buffer de preparo, em pixels.

[out] Pitch

A largura do buffer de preparo, em bytes. O driver deve retornar o valor de pitch porque o buffer de preparo é bloqueável.

Observações

A estrutura de D3DKMDT_STAGINGSURFACEDATA é passada pelo subsistema de kernel de elementos gráficos do Microsoft DirectX em uma chamada para a função DxgkDdiGetGetStandardAllocationDriverData do driver de exibição para gerar uma descrição de uma superfície de preparo bloqueável. O subsistema gráfico chama a função DxgkDdiPresent do driver de miniporto de exibição para emitir solicitações de transferência de bloco de bits (bitblt) para transferir dados do buffer de fundo de um aplicativo para a superfície de preparo. A superfície de preparo é bloqueada e lida pela CPU.

Uma superfície de preparo é potencialmente criada para a operação atual quando uma transferência direta de bloco de bits para a superfície primária não é possível (por exemplo, em casos de vários monitores ou sprites).

Essa superfície de preparo sempre é criada como um formato de pixel RGB de 8 bits por cor (que é especificado pelo valor D3DDDIFMT_X8R8G8B8 da enumeração D3DDDIFORMAT). Como as dimensões da superfície de preparo sempre correspondem às dimensões do buffer traseiro, nenhuma operação de alongamento ou redução é necessária para a operação atual para a superfície de preparo.