Compartir a través de


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

Realiza una operación de transferencia de bloques de bits (bitblt) desde una textura de origen a una textura de destino, incluidos todos los subniveles de la textura de origen. Implementado por windows Display Driver Model (WDDM) 1.2 o controladores de pantalla en modo de 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.

Observaciones

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 para realizar 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 de la textura de origen en la ubicación especificada por el miembro DstPoint miembro de D3DDDIARG_TEXBLT en la textura de destino. Las texturas de origen y de destino se identifican mediante el hDstResource y los identificadores de hSrcResource de D3DDDIARG_TEXBLT, respectivamente.

En el caso de las texturas asignadas a MIP, el controlador también debe copiar todos los subniveles del mapa MIP que están presentes en la textura de origen. Es posible que las texturas de origen y destino contengan 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 subnivel 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íxel de las texturas de origen y destino son idénticos y, en general, la operación bitblt especificada es segura para realizar.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 8
servidor mínimo admitido Windows Server 2012
de la plataforma de destino de Escritorio
encabezado de d3dumddi.h (incluya D3dumddi.h)

Consulte también

Blt

D3DDDIARG_TEXBLT1

D3DDDI_DEVICEFUNCS