PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Rückruffunktion (d3d10umddi.h)

  • Artikel

Die CheckMultisampleQualityLevels-Funktion ruft die Anzahl von Qualitätsstufen ab, die das Gerät für die angegebene Anzahl von Beispielen unterstützt.

Syntax

PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3d10ddiCheckmultisamplequalitylevels;

void Pfnd3d10ddiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE unnamedParam1,
  DXGI_FORMAT unnamedParam2,
  UINT unnamedParam3,
  UINT *unnamedParam4
)
{...}

Parameter

unnamedParam1

hDevice [in]

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

unnamedParam2

Formatieren [in]

Ein DXGI_FORMAT typisierter Wert, der das Renderzielformat angibt, für das die Überprüfung durchgeführt wird.

unnamedParam3

SampleCount [in]

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

unnamedParam4

pNumQualityLevels [out]

Ein Zeiger auf eine Variable, die die Anzahl von Qualitätsstufen empfängt, die das Gerät für die angegebene Anzahl von Beispielen 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-ParameterNULL ist.

Wenn das Gerät mehrere Stichprobenentnahmen mit der Anzahl von Beispielen nicht unterstützt, die im SampleCount-Parameter angegeben ist, sollte der Benutzermodusanzeigetreiber in der Variablen, auf die der pNumQualityLevels-Parameter verweist, 0 zurückgeben.

Wenn der Treiber 1 oder mehr in der Variablen zurückgibt, auf die pNumQualityLevels verweist, gibt der Treiber die Anzahl gerätespezifischer 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 Beispielanzahl 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 unterschiedliche 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 in SampleCount 0 oder größer als 32 empfängt, gibt der Treiber immer 0 in der Variablen zurück, auf die pNumQualityLevels verweist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile d3d10umddi.h (einschließlich D3d10umddi.h)

Weitere Informationen

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb