Init Driver Application Version Extension

Init Driver Application Version Extension#

Introduced in Level Zero version 1.18

API#

Declaring the Application-Supported API Version#

This extension lets an application pass the driver a hint describing the maximum core ‘oneAPI’ Level-Zero API version it was built against and is able to handle. The application supplies the hint in a ze_init_driver_app_version_ext_desc_t struct, chained from the pNext member of ze_init_driver_type_desc_t when calling zeInitDrivers.

The hint is advisory: a driver is free to ignore it. zeDriverGetApiVersion continues to report the version supported by the driver, independently of any version the application declares.

The following rules apply:

  • The apiVersionHint field declares the maximum core ‘oneAPI’ Level-Zero API version the application was built against and is able to handle.

  • A driver may use the hint 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 that acts on the hint should clamp version-gated behavior to the minimum of the version it supports and the version the application declares.