ID3D11Device::CheckMultisampleQualityLevels-Methode (d3d11.h)

  • Artikel

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.hdefiniert. 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

Weitere Informationen

ID3D11Device