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, incluidos todos los 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 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.
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 | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |