PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Rückruffunktion (d3dumddi.h)

Artikel
02/23/2024

Die PfnGetMultisampleMethodListCb-Funktion ruft eine Liste von Methoden mit mehreren Beispielen ab, die für die angegebene Breite, Höhe und das Format einer Zuordnung verwendet werden.

Syntax

PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;

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

Parameter

hAdapter

Ein Handle für das Grafikadapterobjekt.

unnamedParam2

pData [ein, aus]

Ein Zeiger auf eine D3DDDICB_GETMULTISAMPLEMETHODLIST-Struktur , die die Liste der Methoden mit mehreren Beispielen für eine Zuordnung beschreibt.

Rückgabewert

pfnGetMultisampleMethodListCb gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Die Liste der Methoden mit mehreren Beispielen wurde erfolgreich abgerufen.
E_INVALIDARG	Parameter wurden überprüft und als falsch ermittelt.

Diese Funktion kann auch andere HRESULT-Werte zurückgeben.

Hinweise

Der Benutzermodusanzeigetreiber verwendet in der Regel die PfnGetMultisampleMethodListCb-Funktion mit der Funktion CreateResource, CreateResource(D3D10) oder CreateResource(D3D11) und der PfnAllocateCb-Funktion . Der Treiber verwendet pfnGetMultisampleMethodListCb , wenn die Direct3D-Runtime createResource, CreateResource(D3D10) oder CreateResource(D3D11) des Treibers aufruft, um anzufordern, dass der Treiber eine primär mit mehreren Stichproben erstellte. Der Treiber verwendet auch pfnGetMultisampleMethodListCb, wenn er mehrere Stichprobenentnahmen durchführen muss, während er aus der primären Instanz heraus scannt. Diese Art der mehrfachen Stichprobenentnahme verbraucht möglicherweise zusätzliche Speicherbandbreite, die über die bandbreite hinausgeht, die für das Scannen des Anzeigemodus erforderlich ist. Daher fragt pfnGetMultisampleMethodListCb den Anzeigemodus-Manager (DMM) (und indirekt den Anzeigeminiporttreiber) ab, um eine Liste der unterstützten Methoden für mehrere Stichprobenentnahmen für die angegebene Breite, Höhe und das angegebene Format abzurufen. Wenn pfnGetMultisampleMethodListCb meldet, dass keine Methoden unterstützt werden, muss der Benutzermodus-Anzeigetreiber eine Nichtscan-Out-Version von Multiple Sampling verwenden, in der Regel durch Erstellen eines primären Nichtmultiple-Stichproben-Standards.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)