PFND3DDDI_TEXBLT funzione di callback (d3dumddi.h)

  • Articolo

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)

Vedi anche

Blt

D3DDDIARG_TEXBLT

D3DDDI_DEVICEFUNCS