ID3D12Device::CheckFeatureSupport-Methode (d3d12.h)

Artikel
08/23/2023

Ruft Informationen zu den Features ab, die vom aktuellen Grafiktreiber unterstützt werden.

Syntax

HRESULT CheckFeatureSupport(
            D3D12_FEATURE Feature,
  [in, out] void          *pFeatureSupportData,
            UINT          FeatureSupportDataSize
);

Parameter

Feature

Typ: D3D12_FEATURE

Eine Konstante aus der D3D12_FEATURE Enumeration, die die Features beschreibt, die Sie zur Unterstützung abfragen möchten.

[in, out] pFeatureSupportData

Typ: void*

Ein Zeiger auf eine Datenstruktur, die dem Wert des Featureparameters entspricht. Informationen zum Bestimmen der entsprechenden Datenstruktur für jede Konstante finden Sie unter D3D12_FEATURE.

FeatureSupportDataSize

Typ: UINT

Die Größe der Struktur, auf die der pFeatureSupportData-Parameter verweist.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt E_INVALIDARG zurück, wenn ein nicht unterstützter Datentyp an den pFeatureSupportData-Parameter übergeben wird oder wenn ein Größenkonflikt für den FeatureSupportDataSize-Parameter erkannt wird.

Hinweise

Geben Sie als Verwendungsbeispiel die D3D12_FEATURE_DATA_D3D12_OPTIONS5-Struktur im pFeatureSupportData-Parameter an, um die Raytracingunterstützung zu überprüfen. Wenn die Funktion erfolgreich abgeschlossen wurde, greifen Sie auf das RaytracingTier-Feld (das die unterstützte Raytracingebene angibt) der jetzt aufgefüllten D3D12_FEATURE_DATA_D3D12_OPTIONS5-Struktur zu.

Weitere Informationen finden Sie unter Funktionenabfragen.

Hardwareunterstützung für DXGI-Formate

Informationen zum Anzeigen von Tabellen mit DXGI-Formaten und Hardwarefeatures finden Sie unter:

Beispiele

Das D3D1211on12-Beispiel verwendet ID3D12Device::CheckFeatureSupport wie folgt:

inline UINT8 D3D12GetFormatPlaneCount(
    _In_ ID3D12Device* pDevice,
    DXGI_FORMAT Format
    )
{
    D3D12_FEATURE_DATA_FORMAT_INFO formatInfo = {Format};
    if (FAILED(pDevice->CheckFeatureSupport(D3D12_FEATURE_FORMAT_INFO, &formatInfo, sizeof(formatInfo))))
    {
        return 0;
    }
    return formatInfo.PlaneCount;
}

Anforderungen


Zielplattform	Windows
Kopfzeile	d3d12.h
Bibliothek	D3D12.lib
DLL	D3D12.dll

Weitere Informationen

ID3D12Device

Freigeben über