PFND3DDDI_OFFERALLOCATIONS2CB fonction de rappel (d3dumddi.h)

  • Article

Appelé par le pilote d’affichage en mode utilisateur pour offrir des allocations de mémoire vidéo à réutiliser.

Syntaxe

PFND3DDDI_OFFERALLOCATIONS2CB Pfnd3dddiOfferallocations2cb;

HRESULT Pfnd3dddiOfferallocations2cb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS2 *unnamedParam2
)
{...}

Paramètres

hDevice

Handle de l’appareil d’affichage (contexte graphique). Le runtime Direct3D a transmis au pilote en mode utilisateur ce handle en tant que membre hDevice de la structure D3DDDIARG_CREATEDEVICE lors de la création de l’appareil .

unnamedParam2

pData [in]

Pointeur vers une structure de D3DDDICB_OFFERALLOCATIONS2 qui définit les allocations de mémoire vidéo proposées par le pilote.

Valeur retournée

Retourne l’une des valeurs suivantes.

Code de retour Description
S_OK Les allocations ont été proposées avec succès.
Note: Si le pilote n’a pas besoin d’appeler pfnOfferAllocations2Cb , il doit retourner S_OK.
D3DDDIERR_DEVICEREMOVED Le gestionnaire de mémoire vidéo ou le pilote de miniport d’affichage n’ont pas pu terminer l’opération, car un événement d’arrêt de Plug-and-Play (PnP) ou un événement de détection et de récupération de délai d’expiration (TDR) s’est produit.
Note: Si ce code d’erreur est retourné, la fonction appelante du pilote (généralement la routine pfnOfferResources) doit renvoyer ce code d’erreur au runtime Direct3D.
E_INVALIDARG Un paramètre non valide a été fourni.

Remarques

Le pilote d’affichage en mode utilisateur appelle pfnOfferAllocations2Cb pour informer le sous-système du noyau graphique Microsoft DirectX qu’une fois qu’il a terminé toutes les opérations de rendu précédemment soumises, il peut offrir la mémoire des allocations pour d’autres processus à utiliser.

Une fois que le pilote a appelé pfnOfferAllocations2Cb pour proposer une allocation à réutiliser, il doit appeler pfnReclaimAllocations3Cb avant de verrouiller l’allocation ou de l’envoyer pour des opérations de rendu.

pfnOfferAllocations2Cb fonctionne de manière identique à pfnOfferAllocationsCb, sauf qu’il prend en compte les indicateurs via le paramètre pData.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
En-tête d3dumddi.h (inclure D3dumddi.h)

Voir aussi

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS2

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocations3Cb