rtcNewSharedBufferHostDevice(3)                   Embree Ray Tracing Kernels 4

   NAME

              rtcNewSharedBufferHostDevice - creates a new shared data buffer
                with a managed copy of the buffer in device memory


   SYNOPSIS

              #include <embree4/rtcore.h>

              RTCBuffer rtcNewSharedBufferHostDevice(
                RTCDevice device,
                void* ptr,
                size_t byteSize
              );


   DESCRIPTION
       The rtcNewSharedBufferHostDevice function creates a new shared data
       buffer object bound to the specified device (device argument).  The
       buffer object is reference counted with an initial reference count of
       1.  The buffer can be released using the rtcReleaseBuffer function.

       At construction time, the pointer to the user-managed buffer data (ptr
       argument) including its size in bytes (byteSize argument) is provided
       to create the buffer.  At buffer construction time no buffer data is
       allocated on the host, but the buffer data provided by the application
       is used.  A equal sized memory allocation is created on the device.
       The buffer data must remain valid for as long as the buffer may be
       used, and the user is responsible to free the buffer data when no
       longer required.




       The data pointer (ptr argument) must be aligned to 4 bytes; otherwise
       the rtcNewSharedBufferHostDevice function will fail.

       The function rtcCommitBuffer can be used to synchronize the buffer
       content with the device.

   EXIT STATUS
       On failure NULL is returned and an error code is set that can be
       queried using rtcGetDeviceError.

   SEE ALSO
       [rtcNewSharedBuffer], [rtcCommitBuffer], [rtcRetainBuffer],
       [rtcReleaseBuffer]

                                               rtcNewSharedBufferHostDevice(3)