Exposed dpctl.SyclDevice.partition_max_sub_devices property

This change closes #1004.

Author: oleksandr-pavlyk

dpctl/_backend.pxd

@@ -206,6 +206,7 @@ cdef extern from "syclinterface/dpctl_sycl_device_interface.h":
         const DPCTLSyclDeviceRef DRef)
     cdef size_t *DPCTLDevice_GetSubGroupSizes(const DPCTLSyclDeviceRef DRef,
         size_t *res_len)
+    cdef uint32_t DPCTLDevice_GetPartitionMaxSubDevices(const DPCTLSyclDeviceRef DRef)
 
 
 cdef extern from "syclinterface/dpctl_sycl_device_manager.h":

dpctl/_sycl_device.pyx

@@ -55,6 +55,7 @@ from ._backend cimport (  # noqa: E211
     DPCTLDevice_GetMaxWriteImageArgs,
     DPCTLDevice_GetName,
     DPCTLDevice_GetParentDevice,
+    DPCTLDevice_GetPartitionMaxSubDevices,
     DPCTLDevice_GetPlatform,
     DPCTLDevice_GetPreferredVectorWidthChar,
     DPCTLDevice_GetPreferredVectorWidthDouble,
@@ -1292,9 +1293,25 @@ cdef class SyclDevice(_SyclDevice):
         """
         cdef uint64_t cache_line_sz = DPCTLDevice_GetGlobalMemCacheLineSize(
             self._device_ref
-	)
+	    )
         return cache_line_sz
 
+    @property
+    def partition_max_sub_devices(self):
+        """ The maximum number of sub-devices this :class:`dpctl.SyclDevice`
+        instance can be partitioned into. The value returned cannot exceed the
+        value returned by :attr:`dpctl.SyclDevice.max_compute_units`.
+
+        Returns:
+            int: The maximum number of sub-devices that can be created when this
+                device is partitioned. Zero value indicates that device can not
+                be partitioned.
+        """
+        cdef uint32_t max_part = DPCTLDevice_GetPartitionMaxSubDevices(
+            self._device_ref
+        )
+        return max_part
+
     cdef cpp_bool equals(self, SyclDevice other):
         """ Returns ``True`` if the :class:`dpctl.SyclDevice` argument has the
         same _device_ref as this SyclDevice.

dpctl/tests/_device_attributes_checks.py

@@ -540,6 +540,13 @@ def check_parent_device(device):
     assert pd is None or isinstance(pd, dpctl.SyclDevice)
 
 
+def check_partition_max_sub_devices(device):
+    max_part = device.partition_max_sub_devices
+    assert isinstance(max_part, int)
+    assert max_part >= 0
+    assert max_part <= device.max_compute_units
+
+
 def check_filter_string(device):
     try:
         fs = device.filter_string
@@ -670,6 +677,7 @@ def check_global_mem_cache_line_size(device):
     check_profiling_timer_resolution,
     check_platform,
     check_parent_device,
+    check_partition_max_sub_devices,
     check_filter_string,
     check_vendor,
     check_driver_version,