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 passé le 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 D3DDDICB_OFFERALLOCATIONS qui définit les allocations de mémoire vidéo proposées par le pilote.
Valeur de retour
Retourne l’une des valeurs suivantes.
| code de retour | Description |
|---|---|
| S_OK | Les allocations ont été offertes avec succès. Remarque : 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 miniport d’affichage n’a pas pu terminer l’opération, car un événement d’arrêt Plug-and-Play (PnP) ou un événement TDR (Timeout Detection and Recovery) s’est produit. Remarque : Si ce code d’erreur est retourné, la fonction appelante du pilote (généralement la pfnOfferResources routine) 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 toutes les opérations de rendu précédemment envoyées, elle peut offrir la mémoire des allocations pour d’autres processus à utiliser.
Une fois que le pilote appelle pfnOfferAllocationsCb pour offrir une allocation à réutiliser, il doit appeler pfnReclaimAllocationsCb avant de verrouiller l’allocation ou de l’envoyer pour les opérations de rendu.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| serveur minimum pris en charge | Windows Server 2012 |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |