PFNDDXGIDDI_PRESENTCB funzione di callback (dxgiddi.h)

Articolo
10/14/2023

La funzione pfnPresentCbDXGI copia il contenuto da un'allocazione di origine a un'allocazione di destinazione.

Sintassi

PFNDDXGIDDI_PRESENTCB PfnddxgiddiPresentcb;

HRESULT PfnddxgiddiPresentcb(
  HANDLE hDevice,
  DXGIDDICB_PRESENT *unnamedParam2
)
{...}

Parametri

hDevice

[in] Handle per un dispositivo di visualizzazione (contesto grafico).

unnamedParam2

[in] pPresentData è un puntatore a una struttura DXGIDDICB_PRESENT che descrive le allocazioni di origine e destinazione copiate da e verso.

Valore restituito

pfnPresentCbDXGI restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	Il contenuto è stato copiato correttamente.
E_OUTOFMEMORY	PfnPresentCbDXGI non è stato possibile completare a causa di memoria insufficiente.
E_INVALIDARG	I parametri sono stati convalidati e determinati per essere non corretti.

Commenti

Il membro pDXGIContext della struttura DXGIDDICB_PRESENT a cui punta il parametro pPresentData è un meccanismo di comunicazione opaco. Il runtime passa questo contesto DXGI al driver nel membro pDXGIContext della struttura DXGI_DDI_ARG_PRESENT quando il runtime chiama la funzione PresentDXGI del driver. Il driver deve copiare il contesto DXGI invariato nel membro pDXGIContext di DXGIDDICB_PRESENT quando il driver chiama pfnPresentCbDXGI.

Il runtime Direct3D limita il set di formati che possono essere presentati tramite un'operazione bit-block transfer (bitblt). Per altre informazioni sulle restrizioni, vedere la sezione Osservazioni della pagina di riferimento BltDXGI .