PFNDDXGIDDI_PRESENTCB fonction de rappel (dxgiddi.h)

Article
03/01/2024

La fonction pfnPresentCbDXGI copie le contenu d’une allocation source vers une allocation de destination.

Syntaxe

PFNDDXGIDDI_PRESENTCB PfnddxgiddiPresentcb;

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

Paramètres

hDevice

[in] Handle vers un périphérique d’affichage (contexte graphique).

unnamedParam2

[in] pPresentData est un pointeur vers une structure de DXGIDDICB_PRESENT qui décrit les allocations de source et de destination à partir de et vers laquelle le contenu est copié.

Valeur retournée

pfnPresentCbDXGI retourne l’une des valeurs suivantes :

Code de retour	Description
S_OK	Le contenu a été copié avec succès.
E_OUTOFMEMORY	pfnPresentCbDXGI n’a pas pu se terminer en raison d’une mémoire insuffisante.
E_INVALIDARG	Les paramètres ont été validés et déterminés comme incorrects.

Remarques

Le membre pDXGIContext de la structure DXGIDDICB_PRESENT vers laquelle pointe le paramètre pPresentData est un mécanisme de communication opaque. Le runtime transmet ce contexte DXGI au pilote dans le membre pDXGIContext de la structure DXGI_DDI_ARG_PRESENT lorsque le runtime appelle la fonction PresentDXGI du pilote. Le pilote doit copier ce contexte DXGI inchangé dans le membre pDXGIContext de DXGIDDICB_PRESENT quand le pilote appelle pfnPresentCbDXGI.

Le runtime Direct3D limite l’ensemble des formats qui peuvent être présentés par le biais d’une opération de transfert de bloc de bits (bitblt). Pour plus d’informations sur les restrictions, consultez la section Remarques de la page de référence BltDXGI .