PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Rückruffunktion (d3dumddi.h)
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) |