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 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) |