PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Rückruffunktion (d3dumddi.h)
Die pfnGetMultisampleMethodListCb Funktion ruft eine Liste mit Mehrfachbeispielmethoden 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- [in, out]
Ein Zeiger auf eine D3DDDICB_GETMULTISAMPLEMETHODLIST Struktur, die die Liste der Mehrfachbeispielmethoden 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 ermittelt, dass sie falsch sind. |
Diese Funktion kann auch andere HRESULT-Werte zurückgeben.
Bemerkungen
Der Anzeigetreiber für den Benutzermodus verwendet in der Regel die funktion pfnGetMultisampleMethodListCb mit der CreateResource, CreateResource(D3D10)oder CreateResource(D3D11) Funktion und der pfnAllocateCb Funktion. Der Treiber verwendet pfnGetMultisampleMethodListCb, wenn die Direct3D-Laufzeit die CreateResource-des Treibers aufruft, CreateResource(D3D10)-oder CreateResource(D3D11), um anzufordern, dass der Treiber eine primär mit mehreren Stichproben erstellte. Der Treiber verwendet auch pfnGetMultisampleMethodListCb, wenn es mehrere Samplings ausführen muss, während das Scannen von der primären Datei erfolgt. Diese Art von Mehrfachsampling verbraucht möglicherweise zusätzliche Speicherbandbreite, die über die zum Scannen des Anzeigemodus erforderliche Bandbreite hinausgeht. Daher fragt pfnGetMultisampleMethodListCb den Anzeigemodus-Manager (DMM) (und indirekt den Anzeigeminiporttreiber) ab, um eine Liste der unterstützten Mehrfach-Sampling-Methoden für die angegebene Breite, Höhe und Das Format abzurufen. Wenn pfnGetMultisampleMethodListCb meldet, dass keine Methoden unterstützt werden, muss der Anzeigetreiber für den Benutzermodus eine nicht gescannte Version von Mehrfachsampling verwenden, in der Regel durch Erstellen einer standardmäßigen primären Nichtmultiple-Stichprobe.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |