PFND3DDDI_TEXBLT funzione di callback (d3dumddi.h)
La funzione TexBlt esegue un'operazione di trasferimento bit-block (bitblt) da una trama di origine a una trama di destinazione, inclusi tutti i sublevel della trama di origine.
Sintassi
PFND3DDDI_TEXBLT Pfnd3dddiTexblt;
HRESULT Pfnd3dddiTexblt(
HANDLE hDevice,
const D3DDDIARG_TEXBLT *unnamedParam2
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pData [in]
Puntatore a una struttura D3DDDIARG_TEXBLT che definisce i parametri per l'operazione bitblt della trama.
Valore restituito
TexBlt restituisce S_OK o un risultato di errore appropriato se l'operazione bitblt della trama non viene eseguita correttamente.
Commenti
Il runtime di Microsoft Direct3D chiama la funzione TexBlt del driver di visualizzazione in modalità utente per informare il driver di eseguire un'operazione bitblt da una trama di origine a una trama di destinazione. Una trama può anche essere una mappa di ambiente cubica. Il driver deve copiare il rettangolo specificato dal membro SrcRect della struttura D3DDDIARG_TEXBLT nella trama di origine nella posizione specificata dal membro DstPoint di D3DDDIARG_TEXBLT nella trama di destinazione. Le trame di destinazione e di origine sono identificate rispettivamente dagli handle hDstResource e hSrcResource di D3DDDIARG_TEXBLT.
Per le trame mappate MIP, il driver deve anche copiare tutti i sublevel della mappa MIP presenti nella trama di origine. Le trame di origine e destinazione potrebbero contenere numeri diversi di livelli di mappa MIP. In questa situazione, il driver deve copiare i livelli comuni. Ad esempio, se una trama di origine di 256x256 ha otto livelli di mappa MIP e se la destinazione è una trama di 64x64 con sei livelli, il driver deve copiare i sei livelli corrispondenti dall'origine. Si noti che le dimensioni del livello MIP superiore della trama di destinazione sono sempre inferiori o uguali alle dimensioni del livello MIP superiore della trama di origine.
Gli handle di origine e destinazione fanno sempre riferimento alle superfici di primo livello e non a nessuna sublevel della mappa MIP.
Per copiare un livello arbitrario di una trama mappa MIP, il runtime chiama invece la funzione Blt del driver.
I formati pixel delle trame di origine e di destinazione sono identici e, in generale, l'operazione bitblt specificata è sicura da eseguire.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dumddi.h (include D3dumddi.h) |