[SYCL][COMPAT] Add a free function version of has_capability_or_fail

Signed-off-by: Jiang, Zhiwei <[email protected]>

Author: zhiweij1

sycl/doc/syclcompat/README.md

@@ -1048,6 +1048,10 @@ static inline unsigned int get_device_id(const sycl::device &dev);
 // Util function to get the number of available devices
 static inline unsigned int device_count();
 
+// Util function to check whether a device supports some kinds of sycl::aspect.
+static inline void
+has_capability_or_fail(const sycl::device &dev,
+                       const std::initializer_list<sycl::aspect> &props);
 } // syclcompat
 ```
 

sycl/include/syclcompat/device.hpp

@@ -959,4 +959,10 @@ static inline unsigned int get_device_id(const sycl::device &dev) {
 static inline unsigned int device_count() {
   return detail::dev_mgr::instance().device_count();
 }
+
+static inline void
+has_capability_or_fail(const sycl::device &dev,
+                       const std::initializer_list<sycl::aspect> &props) {
+  get_device(get_device_id(dev)).has_capability_or_fail(props);
+}
 } // namespace syclcompat