PFND3DDDI_TEXBLT función de devolución de llamada (d3dumddi.h)

La función TexBlt realiza una operación de transferencia de bloques de bits (bitblt) de una textura de origen a una textura de destino, incluidas todas las subniveles de la textura de origen.

Sintaxis

PFND3DDDI_TEXBLT Pfnd3dddiTexblt;

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

Parámetros

hDevice

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

pData [in]

Puntero a una estructura de D3DDDIARG_TEXBLT que define los parámetros para la operación bitblt de textura.

Valor devuelto

TexBlt devuelve S_OK o un resultado de error adecuado si la operación bitblt de textura no se realiza correctamente.

Comentarios

El tiempo de ejecución de Microsoft Direct3D llama a la función TexBlt del controlador de pantalla en modo de usuario para informar al controlador de que realice una operación bitblt desde una textura de origen a una textura de destino. Una textura también puede ser un mapa de entorno cúbico. El controlador debe copiar el rectángulo especificado por el miembro SrcRect de la estructura D3DDDIARG_TEXBLT en la textura de origen en la ubicación especificada por el miembro DstPoint de D3DDDIARG_TEXBLT en la textura de destino. Las texturas de origen y de destino se identifican mediante los identificadores hDstResource y hSrcResource de D3DDDIARG_TEXBLT, respectivamente.

En el caso de las texturas asignadas a MIP, el controlador también debe copiar todos los subveles del mapa de MIP que están presentes en la textura de origen. Las texturas de origen y destino pueden contener diferentes números de niveles de mapa MIP. En esta situación, el controlador debe copiar los niveles comunes. Por ejemplo, si una textura de origen de 256x256 tiene ocho niveles de mapa MIP y si el destino es una textura de 64 x 64 con seis niveles, el controlador debe copiar los seis niveles correspondientes del origen. Tenga en cuenta que las dimensiones del nivel de MIP superior de la textura de destino siempre son menores o iguales que las dimensiones del nivel de MIP superior de la textura de origen.

Los identificadores de origen y destino siempre hacen referencia a las superficies de nivel superior y nunca a ningún subvel de mapa MIP.

Para copiar un nivel arbitrario de una textura de mapa de MIP, el tiempo de ejecución llama a la función Blt del controlador en su lugar.

Los formatos de píxeles de las texturas de origen y destino son idénticos y, en general, la operación bitblt especificada es segura para realizar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	d3dumddi.h (incluya D3dumddi.h)

Consulte también

Blt

D3DDDIARG_TEXBLT

D3DDDI_DEVICEFUNCS