PFND3DDDI_OFFERALLOCATIONSCB 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_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;

HRESULT Pfnd3dddiOfferallocationscb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS *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_OFFERALLOCATIONS 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 pfnOfferAllocationsCb, 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 pfnOfferAllocationsCb 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 que d’autres processus puissent être utilisés.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Serveur minimal pris en charge Windows Server 2012
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dumddi.h (inclure D3dumddi.h)

Voir aussi

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocationsCb