Global - Extensions

Global - Extensions#

oneAPI Level Zero Specification - Version 1.18.31

Global - Extension Structures#

ze_init_driver_app_version_ext_desc_t#

Added in version 1.18

struct ze_init_driver_app_version_ext_desc_t#

Declares the maximum core API version supported by the application.

  • This structure may be passed to zeInitDrivers, via the pNext member of ze_init_driver_type_desc_t, to declare the maximum core API version the application was built against and is able to handle.

  • ’oneAPI’ Level-Zero otherwise provides no mechanism for an application to communicate the API version it supports to a driver; zeDriverGetApiVersion only reports the version supported by the driver, not the application. A driver may use the application-declared version to gate version-dependent behavior for backward compatibility, for example only reporting enumerants or memory types introduced in newer API versions to applications that understand them.

  • If this structure is not provided, the driver must assume the application supports only the baseline behavior and must not rely on any version-gated behavior being understood by the application.

  • A driver should clamp version-gated behavior to the minimum of the version it supports and the version the application declares.

Public Members

ze_structure_type_t stype#

[in] type of this structure

const void *pNext#

[in][optional] must be null or a pointer to an extension-specific structure (i.e. contains stype and pNext).

ze_api_version_t apiVersionHint#

[in] maximum core ‘oneAPI’ Level-Zero API version supported by the application.

In this class