ID3D11Device::CheckMultisampleQualityLevels-Methode (d3d11.h)
Rufen Sie die Anzahl der beim Multisampling verfügbaren Qualitätsstufen ab.
Syntax
HRESULT CheckMultisampleQualityLevels(
[in] DXGI_FORMAT Format,
[in] UINT SampleCount,
[out] UINT *pNumQualityLevels
);
Parameter
[in] Format
Typ: DXGI_FORMAT
Das Texturformat. Siehe DXGI_FORMAT.
[in] SampleCount
Typ: UINT
Die Anzahl der Stichproben während des Multisamplings.
[out] pNumQualityLevels
Typ: UINT*
Anzahl der vom Adapter unterstützten Qualitätsstufen. Siehe Hinweise.
Rückgabewert
Typ: HRESULT
Diese Methode gibt einen der folgenden Direct3D 11-Rückgabecodes zurück.
Hinweise
Beim Multisampling einer Textur hängt die Anzahl der verfügbaren Qualitätsstufen für einen Adapter vom verwendeten Texturformat und der Anzahl der angeforderten Proben ab. Die maximale Anzahl von Qualitätsstufen wird durch D3D11_MAX_MULTISAMPLE_SAMPLE_COUNT in D3D11.h
definiert. Wenn diese Methode 0 (S_OK) zurückgibt und der Ausgabeparameter pNumQualityLevels
einen positiven Wert empfängt, wird die Kombination aus Format und Stichprobenanzahl für das Gerät unterstützt. Wenn die Kombination nicht unterstützt wird, gibt diese Methode einen fehlerbehafteten HRESULT-Code (d. h. eine negative ganze Zahl) zurück oder legt pNumQualityLevels
den Ausgabeparameter auf 0 oder beides fest.
Darüber hinaus bleibt die Definition eines Qualitätsniveaus jedem Hardwarehersteller überlassen; Direct3D bietet jedoch keine Möglichkeit, diese Informationen zu ermitteln.
Beachten Sie, dass FEATURE_LEVEL_10_1 Geräte für alle Renderziele außer R32G32B32A32 und R32G32B32 das 4-fache MSAA unterstützen müssen. FEATURE_LEVEL_11_0 Geräte müssen 4x MSAA für alle Renderzielformate und 8x MSAA für alle Renderzielformate mit Ausnahme R32G32B32A32-Formate unterstützen.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | d3d11.h |
Bibliothek | D3D11.lib |