Add Support for Reporting IPC Fabric Accessible handle type creation (#450)

* Add IPC Fabric Accessible Support flag and expectations

* Refine documentation on the IPC handle types

Signed-off-by: Neil R. Spruit <neil.r.spruit@intel.com>

Author: nrspruit

scripts/core/EXT_IPC_MEM_HANDLE_TYPE.rst

@@ -39,6 +39,24 @@ When users are requesting IPC handles for L0 memory, there may be requirements f
 
 To facilitate this, the IPC Memory Handle Type Extension provides a mechanism to specify the type of IPC handle to be created during memory allocation or when obtaining an IPC handle for existing memory.
 
+Checking IPC Support
+~~~~~~~~~~~~~~~~~~~~~
+
+Before requesting a specific IPC handle type, users can query the driver to determine what IPC handle types are supported by checking the IPC property flags:
+
+.. parsed-literal::
+
+    ${x}_ipc_properties_t ipcProps;
+    ${x}DeviceGetIpcProperties(hDevice, &ipcProps);
+    
+    if (ipcProps.flags & ${X}_IPC_PROPERTY_FLAG_FABRIC_ACCESSIBLE) {
+        // Driver supports fabric accessible IPC handles
+    } else {
+        // Fabric accessible IPC handles are not supported
+    }
+
+This approach allows applications to determine available IPC capabilities before attempting to create handles or allocate memory with specific IPC requirements.
+
 Get IPC Handle Usage Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -55,6 +73,10 @@ To request an IPC handle for L0 memory that is fabric accessible, the user would
     ze_ipc_mem_handle_t ipcHandle;
     ze_result_t result = zeMemGetIpcHandleWithProperties(hContext, ptr, &ipcHandle, &desc);
 
+.. note::
+
+    If the driver does not support ``ZE_IPC_MEM_HANDLE_TYPE_FLAG_FABRIC_ACCESSIBLE``, the function will return ``ZE_RESULT_ERROR_UNSUPPORTED_FEATURE``. Applications can proactively check for support by querying ``${x}_ipc_properties_t`` as shown in the "Checking IPC Support" section above.
+
 
 Memory Allocation Usage Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -94,4 +116,8 @@ To allocate L0 memory with an IPC handle that is fabric accessible, the user wou
         .size = size
     };
     void* physical_ptr = NULL;
-    ze_result_t result = zePhysicalMemCreate(hContext, &physicalDesc, &physical_ptr);
+    ze_result_t result = zePhysicalMemCreate(hContext, &physicalDesc, &physical_ptr);
+
+.. note::
+
+    If the driver does not support ``ZE_IPC_MEM_HANDLE_TYPE_FLAG_FABRIC_ACCESSIBLE``, the memory allocation functions (``zeMemAllocDevice``, ``zeMemAllocHost``, ``zePhysicalMemCreate``) will return ``ZE_RESULT_ERROR_UNSUPPORTED_FEATURE``. Applications can proactively check for support by querying ``${x}_ipc_properties_t`` as shown in the "Checking IPC Support" section above.

scripts/core/driver.yml

@@ -299,6 +299,9 @@ etors:
       desc: "Supports passing memory allocations between processes. See $xMemGetIpcHandle."
     - name: EVENT_POOL
       desc: "Supports passing event pools between processes. See $xEventPoolGetIpcHandle."
+    - name: FABRIC_ACCESSIBLE
+      version: "1.16"
+      desc: "Supports creating a handle type for memory allocations and event pools between processes on different physical devices connected through a fabric interconnect. See $x_ipc_mem_handle_type_ext_desc_t."
 --- #--------------------------------------------------------------------------
 type: struct
 desc: "IPC properties queried using $xDriverGetIpcProperties"

scripts/core/ipcMemHandleType.yml

@@ -33,10 +33,10 @@ version: "1.15"
 etors:
     - name: DEFAULT
       value: "$X_BIT(0)"
-      desc: "Local IPC memory handle type for use within the same machine."
+      desc: "Local IPC memory handle type for use within the same device. This is the default if no flags are specified and does not indicate if the handle is shareable across devices or machines."
     - name: FABRIC_ACCESSIBLE
       value: "$X_BIT(1)"
-      desc: "Fabric accessible IPC memory handle type for use across machines via a supported fabric."
+      desc: "Fabric accessible IPC memory handle type for use across devices or machines via a supported fabric."
 --- #--------------------------------------------------------------------------
 type: struct
 desc: