PFND3DDDI_GETMULTISAMPLEMETHODLISTCB fonction de rappel (d3dumddi.h)

Article
02/23/2024

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

Syntaxe

PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;

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

Paramètres

hAdapter

Handle de l’objet d’adaptateur graphique.

unnamedParam2

pData [in, out]

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

Valeur retournée

pfnGetMultisampleMethodListCb retourne l’une des valeurs suivantes :

Code de retour	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) et la fonction pfnAllocateCb . Le pilote utilise pfnGetMultisampleMethodListCb lorsque le runtime Direct3D appelle createResource, CreateResource(D3D10)ou CreateResource(D3D11) du pilote pour demander que le pilote crée un fichier principal à échantillon multiple. Le pilote utilise également pfnGetMultisampleMethodListCb lorsqu’il doit effectuer plusieurs échantillonnages lors de l’analyse à partir du principal. Ce type d’échantillonnage multiple peut consommer une bande passante mémoire supplémentaire, au-delà de la bande passante nécessaire pour analyser le mode d’affichage. Par conséquent, pfnGetMultisampleMethodListCb interroge le gestionnaire de mode d’affichage (DMM) (et indirectement le pilote miniport d’affichage) pour récupérer une liste des méthodes d’échantillonnage multiple prises en charge pour la largeur, la hauteur et le format donnés. Si pfnGetMultisampleMethodListCb indique qu’aucune méthode n’est prise en charge, le pilote d’affichage en mode utilisateur doit utiliser une version non d’analyse hors analyse de l’échantillonnage multiple, généralement en créant un échantillon principal standard non multimultiple.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dumddi.h (inclure D3dumddi.h)