PFND3DDDI_TEXBLT1 funzione di callback (d3dumddi.h)

  • Articolo

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. Implementato dai driver di visualizzazione Windows Display Driver Model (WDDM) 1.2 o versioni successive.

Sintassi

PFND3DDDI_TEXBLT1 Pfnd3dddiTexblt1;

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

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pData [in]

Puntatore a una struttura D3DDDIARG_TEXBLT1 che definisce i parametri per l'operazione bitblt della trama.

Valore restituito

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 a MIP, il driver deve anche copiare tutti i sublevel della mappa MIP presenti nella trama di origine. Le trame di origine e di destinazione potrebbero contenere numeri diversi di livelli di mappa MIP. In questo caso, il driver deve copiare i livelli comuni. Ad esempio, se una trama di origine 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 minori o uguali alle dimensioni del livello MIP principale della trama di origine.

Gli handle di origine e di destinazione fanno sempre riferimento alle superfici di primo livello e non a nessun livello di ridimensionamento della mappa MIP.

Per copiare un livello arbitrario di una trama della 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 Windows 8
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Desktop
Intestazione d3dumddi.h (include D3dumddi.h)

Vedi anche

Blt

D3DDDIARG_TEXBLT1

D3DDDI_DEVICEFUNCS