.. _experimental-usm-host-alloc-register: ================================================================================ USM Host Alloc Register ================================================================================ .. warning:: Experimental features: * May be replaced, updated, or removed at any time. * Do not require maintaining API/ABI stability of their own additions over time. * Do not require conformance testing of their own additions. Motivation -------------------------------------------------------------------------------- This extension enables applications to register externally-allocated host memory (such as memory-mapped files or standard malloc allocations) with the runtime, allowing the device to access it efficiently as USM host memory without requiring data copies. API -------------------------------------------------------------------------------- Enums ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * :ref:`ur-device-info-t` * :ref:`UR_DEVICE_INFO_USM_HOST_ALLOC_REGISTER_SUPPORT_EXP ` * :ref:`ur-structure-type-t` * :ref:`UR_STRUCTURE_TYPE_EXP_USM_HOST_ALLOC_REGISTER_PROPERTIES ` Functions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * :ref:`urUSMHostAllocRegisterExp` * :ref:`urUSMHostAllocUnregisterExp` Changelog -------------------------------------------------------------------------------- +-----------+---------------------------+ | Revision | Changes | +===========+===========================+ | 1.0 | Initial Draft | +-----------+---------------------------+ Support -------------------------------------------------------------------------------- Adapters which support this experimental feature *must* return true for the new ``:ref:`UR_DEVICE_INFO_USM_HOST_ALLOC_REGISTER_SUPPORT_EXP `\`` device info query. Contributors -------------------------------------------------------------------------------- * Krzysztof Swiecicki `krzysztof.swiecicki@intel.com `_