Class KHRDeviceUUID


  • public final class KHRDeviceUUID
    extends java.lang.Object
    Native bindings to the khr_device_uuid extension.

    This extension adds the ability to query a universally unique identifier (UUID) for an OpenCL driver and OpenCL device. The UUIDs returned by the query may be used to identify drivers and devices across processes or APIs.

    • Field Detail

      • CL_DEVICE_UUID_KHR

        public static final int CL_DEVICE_UUID_KHR
        Returns a universally unique identifier (UUID) for the device. (cl_uchar[CL_UUID_SIZE_KHR])

        Device UUIDs must be immutable for a given device across processes, driver APIs, driver versions, and system reboots.

        See Also:
        Constant Field Values
      • CL_DRIVER_UUID_KHR

        public static final int CL_DRIVER_UUID_KHR
        Returns a universally unique identifier (UUID) for the software driver for the device. (cl_uchar[CL_UUID_SIZE_KHR])
        See Also:
        Constant Field Values
      • CL_DEVICE_LUID_VALID_KHR

        public static final int CL_DEVICE_LUID_VALID_KHR
        Returns TRUE if the device has a valid LUID and FALSE otherwise. (cl_bool)
        See Also:
        Constant Field Values
      • CL_DEVICE_LUID_KHR

        public static final int CL_DEVICE_LUID_KHR
        Returns a locally unique identifier (LUID) for the device. (cl_uchar[CL_LUID_SIZE_KHR])

        It is not an error to query CL_DEVICE_LUID_KHR when DEVICE_LUID_VALID_KHR returns FALSE, but in this case the returned LUID value is undefined.

        When CL_DEVICE_LUID_VALID_KHR returns TRUE, and the OpenCL device is running on the Windows operating system, the returned LUID value can be cast to an LUID object and must be equal to the locally unique identifier of an IDXGIAdapter1 object that corresponds to the OpenCL device.

        See Also:
        Constant Field Values
      • CL_DEVICE_NODE_MASK_KHR

        public static final int CL_DEVICE_NODE_MASK_KHR
        Returns a node mask for the device. (cl_uint)

        It is not an error to query CL_DEVICE_NODE_MASK_KHR when DEVICE_LUID_VALID_KHR returns FALSE, but in this case the returned node mask is undefined.

        When CL_DEVICE_LUID_VALID_KHR returns TRUE, the returned node mask must contain exactly one bit. If the OpenCL device is running on an operating system that supports the Direct3D 12 API and the OpenCL device corresponds to an individual device in a linked device adapter, the returned node mask identifies the Direct3D 12 node corresponding to the OpenCL device. Otherwise, the returned node mask must be 1.

        See Also:
        Constant Field Values