PFND3DDDI_TEXBLT função de retorno de chamada (d3dumddi.h)

A função TexBlt executa uma operação de transferência de bloco de bits (bitblt) de uma textura de origem para uma textura de destino, incluindo todos os subnível da textura de origem.

Sintaxe

PFND3DDDI_TEXBLT Pfnd3dddiTexblt;

HRESULT Pfnd3dddiTexblt(
  HANDLE hDevice,
  const D3DDDIARG_TEXBLT *unnamedParam2
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

pData [in]

Um ponteiro para uma estrutura D3DDDIARG_TEXBLT que define os parâmetros para a operação bitblt de textura.

Retornar valor

TexBlt retornará S_OK ou um resultado de erro apropriado se a operação bitblt de textura não for executada com êxito.

Comentários

O runtime do Microsoft Direct3D chama a função TexBlt do driver de exibição do modo de usuário para informar o driver a executar uma operação bitblt de uma textura de origem para uma textura de destino. Uma textura também pode ser um mapa de ambiente cúbico. O driver deve copiar o retângulo especificado pelo membro SrcRect da estrutura D3DDDIARG_TEXBLT na textura de origem para o local especificado pelo membro do DstPoint de D3DDDIARG_TEXBLT na textura de destino. As texturas de destino e de origem são identificadas pelas alças hDstResource e hSrcResource de D3DDDIARG_TEXBLT, respectivamente.

Para texturas mapeadas por MIP, o driver também deve copiar todos os subnível do mapa MIP presentes na textura de origem. As texturas de origem e destino podem conter números diferentes de níveis de mapa MIP. Nessa situação, o driver deve copiar os níveis comuns. Por exemplo, se uma textura de origem 256x256 tiver oito níveis de mapa MIP e se o destino for uma textura 64x64 com seis níveis, o driver deverá copiar os seis níveis correspondentes da origem. Observe que as dimensões do nível de MIP superior da textura de destino são sempre menores ou iguais às dimensões do nível de MIP superior da textura de origem.

Os identificadores de origem e destino sempre se referem às superfícies de nível superior e nunca a nenhum subnível de mapa MIP.

Para copiar um nível arbitrário de uma textura de mapa MIP, o runtime chama a função Blt do driver.

Os formatos de pixel das texturas de origem e destino são idênticos e, em geral, a operação bitblt especificada é segura para executar.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dumddi.h (inclua D3dumddi.h)

Confira também

Blt

D3DDDIARG_TEXBLT

D3DDDI_DEVICEFUNCS