pub unsafe extern "C" fn cuMulticastCreate(
mcHandle: *mut CUmemGenericAllocationHandle,
prop: *const CUmulticastObjectProp,
) -> CUresultExpand description
\brief Create a generic allocation handle representing a multicast object described by the given properties.
This creates a multicast object as described by \p prop. The number of participating devices is specified by ::CUmulticastObjectProp::numDevices. Devices can be added to the multicast object via ::cuMulticastAddDevice. All participating devices must be added to the multicast object before memory can be bound to it. Memory is bound to the multicast object via either ::cuMulticastBindMem or ::cuMulticastBindAddr, and can be unbound via ::cuMulticastUnbind. The total amount of memory that can be bound per device is specified by :CUmulticastObjectProp::size. This size must be a multiple of the value returned by ::cuMulticastGetGranularity with the flag ::CU_MULTICAST_GRANULARITY_MINIMUM. For best performance however, the size should be aligned to the value returned by ::cuMulticastGetGranularity with the flag ::CU_MULTICAST_GRANULARITY_RECOMMENDED.
After all participating devices have been added, multicast objects can also be mapped to a device’s virtual address space using the virtual memory management APIs (see ::cuMemMap and ::cuMemSetAccess). Multicast objects can also be shared with other processes by requesting a shareable handle via ::cuMemExportToShareableHandle. Note that the desired types of shareable handles must be specified in the bitmask ::CUmulticastObjectProp::handleTypes. Multicast objects can be released using the virtual memory management API ::cuMemRelease.
\param[out] mcHandle Value of handle returned. \param[in] prop Properties of the multicast object to create.
\return ::CUDA_SUCCESS, ::CUDA_ERROR_INVALID_VALUE, ::CUDA_ERROR_OUT_OF_MEMORY, ::CUDA_ERROR_INVALID_DEVICE, ::CUDA_ERROR_NOT_INITIALIZED, ::CUDA_ERROR_DEINITIALIZED, ::CUDA_ERROR_NOT_PERMITTED, ::CUDA_ERROR_NOT_SUPPORTED
\sa ::cuMulticastAddDevice, ::cuMulticastBindMem, ::cuMulticastBindAddr, ::cuMulticastUnbind \sa ::cuMemCreate, ::cuMemRelease, ::cuMemExportToShareableHandle, ::cuMemImportFromShareableHandle