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

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. Implementado por windows Display Driver Model (WDDM) 1.2 o controladores de pantalla en modo usuario posteriores.

Sintaxis

PFND3DDDI_TEXBLT1 Pfnd3dddiTexblt1;

HRESULT Pfnd3dddiTexblt1(
  HANDLE hDevice,
  const D3DDDIARG_TEXBLT1 *unnamedParam2
)
{...}

Parámetros

hDevice

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

unnamedParam2

pData [in]

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

Valor devuelto

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	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Escritorio
Encabezado	d3dumddi.h (incluya D3dumddi.h)

Consulte también

Blt

D3DDDIARG_TEXBLT1

D3DDDI_DEVICEFUNCS