PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS Rückruffunktion (d3d10umddi.h)

  • Artikel

PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS ruft die Anzahl der Qualitätsstufen ab, die das Gerät für die angegebene Anzahl von Stichproben 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 durchgefü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 mithilfe einer bitweisen OR-Operation 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 Stichproben unterstützt.

Rückgabewert

Keine

Bemerkungen

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

Wenn das Gerät keine mehrfache Stichprobenentnahme mit der Anzahl von Stichproben unterstützt, die im SampleCount-Parameter angegeben ist, sollte der Benutzermodusanzeigetreiber in der Variablen null zurückgeben, auf die der Parameter pNumQualityLevels 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 Stichprobenanzahl verfügbar sind. Wenn der Treiber beispielsweise 3 zurückgibt, können die Qualitätsebenen 0, 1 und 2 verwendet werden, um Ressourcen mit der angegebenen Stichprobenanzahl zu erstellen. Der Gerätehersteller definiert diese Qualitätsstufen, die von der Microsoft Direct3D-Runtime nicht abgefragt werden können. Unterschiedliche Qualitätsstufen bei einer festen Stichprobenanzahl können sich jedoch auf unterschiedliche räumliche Layouts der Stichprobenstandorte oder auf verschiedene Auflösungsmethoden beziehen.

Wenn der Treiber 1 in SampleCount empfä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 SampleCount empfängt, gibt der Treiber immer 0 in der Variablen zurück, auf die pNumQualityLevels zeigt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 (WDDM 1.3)
Unterstützte Mindestversion (Server) Windows Server 2012 R2
Zielplattform Desktop
Kopfzeile d3d10umddi.h (include D3d10umddi.h)

Weitere Informationen

CheckMultisampleQualityLevels

D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG

DXGI_FORMAT

pfnSetErrorCb