DML_FEATURE_QUERY_FEATURE_LEVELS structure (directml.h)

Article
02/22/2024

Used to query a DirectML device for its support for one or more feature levels. See IDMLDevice::CheckFeatureSupport. The feature constant is DML_FEATURE_FEATURE_LEVELS, and the support data type is DML_FEATURE_DATA_FEATURE_LEVELS.

Syntax

struct DML_FEATURE_QUERY_FEATURE_LEVELS {
  UINT                    RequestedFeatureLevelCount;
  const DML_FEATURE_LEVEL *RequestedFeatureLevels;
};

Members

RequestedFeatureLevelCount

Type: UINT

The number of elements in the RequestedFeatureLevels array.

RequestedFeatureLevels

Type: _Field_size_(RequestedFeatureLevelCount) DML_FEATURE_LEVEL*

An array of feature levels to query support for. When IDMLDevice::CheckFeatureSupport returns, the DML_FEATURE_DATA_FEATURE_LEVELS struct contains the highest feature level in this array that is supported by the device.

Remarks

This query is useful in combination with the minimumFeatureLevel parameter of DMLCreateDevice1. By supplying a minimum feature level to DMLCreateDevice1, you can be guaranteed a lower bound to the underlying DirectML device's feature level support.

Using this query, you can then also retrieve an upper bound for the feature levels supported by this DirectML device. This information can then be used to achieve graceful fallbacks in cases where particular features are unavailable.

Availability

This API was introduced in DirectML version 1.1.0.

Requirements

Requirement	Value
Minimum supported client	Windows 10 Build 20348
Minimum supported server	Windows 10 Build 20348
Header	directml.h