PFND3DDDI_OFFERALLOCATIONSCB fonction de rappel (d3dumddi.h)
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) |