PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS Rückruffunktion (d3d10umddi.h)

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS ruft die Anzahl der Qualitätsstufen ab, die das Gerät für die angegebene Anzahl von Beispielen unterstützt.

Syntax

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3dwddm13DdiCheckmultisamplequalitylevels;

void Pfnd3dwddm13DdiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE hDevice,
  DXGI_FORMAT Format,
  UINT SampleCount,
  UINT Flags,
  UINT *pNumQualityLevels
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

Format

Ein Wert vom Typ DXGI_FORMAT, der das Renderzielformat angibt, für das die Überprüfung ausgeführt wird.

SampleCount

Die Anzahl der Beispiele, für die die Qualitätsstufen abgerufen werden sollen.

Flags

Eine Kombination aus D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG Werten, die mit einem bitweisen OR-Vorgang kombiniert werden.

pNumQualityLevels

Ein Zeiger auf eine Variable, die die Anzahl der Qualitätsstufen empfängt, die das Gerät für die angegebene Anzahl von Beispielen unterstützt.

Rückgabewert

Nichts

Bemerkungen

Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen. Der Treiber kann E_INVALIDARG festlegen, wenn das Format im parameter Format nicht vorhanden ist oder der pNumQualityLevels Parameter NULL ist.

Wenn das Gerät kein mehrfaches Sampling mit der Anzahl der Beispiele unterstützt, die im parameter SampleCount angegeben sind, sollte der Anzeigetreiber für den Benutzermodus null in der Variablen zurückgeben, auf die der pNumQualityLevels Parameter verweist.

Wenn der Treiber 1 oder mehr in der Variablen zurückgibt , auf die pNumQualityLevels verweist, gibt der Treiber die Anzahl der gerätespezifischen Samplingvariationen an, die mit der angegebenen Beispielanzahl verfügbar sind. Wenn der Treiber beispielsweise 3 zurückgibt, können Die Qualitätsstufen 0, 1 und 2 zum Erstellen von Ressourcen mit der angegebenen Beispielanzahl verwendet werden. Der Gerätehersteller definiert diese Qualitätsstufen, die von der Microsoft Direct3D-Laufzeit nicht abgefragt werden können. Bei einer festen Stichprobenanzahl können jedoch unterschiedliche räumliche Layouts der Stichprobenstandorte oder verschiedene Methoden zur Auflösung unterschiedlich sein.

Wenn der Treiber 1 in SampleCountempfängt, gibt der Treiber immer 1 in der Variablen zurück , auf die pNumQualityLevels verweist.

Wenn der Treiber 0 oder größer als 32 in SampleCounterhält, gibt der Treiber immer 0 in der Variablen zurück , auf die pNumQualityLevels verweist.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8.1 (WDDM 1.3)
mindestens unterstützte Server-	Windows Server 2012 R2
Zielplattform-	Desktop
Header-	d3d10umddi.h (include D3d10umddi.h)

Siehe auch

CheckMultisampleQualityLevels

D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG

DXGI_FORMAT

pfnSetErrorCb