PFND3DDDI_OFFERALLOCATIONS2CB 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_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) |