Partager via


PFND3DDDI_GETMULTISAMPLEMETHODLISTCB fonction de rappel (d3dumddi.h)

La fonction pfnGetMultisampleMethodListCb récupère une liste de méthodes à plusieurs exemples utilisés pour la largeur, la hauteur et le format d’une allocation donnée.

Syntaxe

PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;

HRESULT Pfnd3dddiGetmultisamplemethodlistcb(
  HANDLE hAdapter,
  D3DDDICB_GETMULTISAMPLEMETHODLIST *unnamedParam2
)
{...}

Paramètres

hAdapter

Handle de l’objet adaptateur graphique.

unnamedParam2

pData [in, out]

Pointeur vers une structure D3DDDICB_GETMULTISAMPLEMETHODLIST qui décrit la liste des méthodes à plusieurs exemples pour une allocation.

Valeur de retour

pfnGetMultisampleMethodListCb retourne l’une des valeurs suivantes :

Retourner le code Description
S_OK La liste des méthodes à plusieurs exemples a été récupérée avec succès.
E_INVALIDARG Les paramètres ont été validés et déterminés comme incorrects.

Cette fonction peut également retourner d’autres valeurs HRESULT.

Remarques

Le pilote d’affichage en mode utilisateur utilise généralement la fonction pfnGetMultisampleMethodListCb avec sa fonction CreateResource, CreateResource(D3D10)ou CreateResource(D3D11) fonction et la fonction pfnAllocateCb. Le pilote utilise pfnGetMultisampleMethodListCb lorsque le runtime Direct3D appelle le CreateResourcedu pilote, CreateResource(D3D10), ou CreateResource(D3D11) pour demander que le pilote crée un principal à plusieurs échantillons. Le pilote utilise également pfnGetMultisampleMethodListCb lorsqu’il doit effectuer plusieurs échantillonnages lors de l’analyse à partir du serveur principal. Ce type d’échantillonnage multiple peut consommer une bande passante mémoire supplémentaire, au-delà de la bande passante requise pour analyser le mode d’affichage. Par conséquent, pfnGetMultisampleMethodListCb interroge le gestionnaire de mode d’affichage (DMM) (et indirectement le pilote de miniport d’affichage) pour récupérer une liste de méthodes d’échantillonnage multiple prises en charge pour la largeur, la hauteur et le format donnés. Si pfnGetMultisampleMethodListCb signale qu’aucune méthode n’est prise en charge, le pilote d’affichage en mode utilisateur doit utiliser une version sans analyse de plusieurs échantillonnages, généralement en créant un principal non-échantillonné standard.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible Bureau
d’en-tête d3dumddi.h (include D3dumddi.h)

Voir aussi

createResource

CreateResource(D3D10)

createResource(D3D11)

D3DDDICB_GETMULTISAMPLEMETHODLIST

D3DDDI_ADAPTERCALLBACKS

D3DDDI_DEVICEFUNCS