mxGPUCreateFromMxArray (C)

R2026b

Create read-only mxGPUArray object from input mxArray

C Syntax

#include "gpu/mxGPUArray.h"
mxGPUArray const * mxGPUCreateFromMxArray(mxArray const * const mp)

Arguments

mp

Pointer to an mxArray that contains either GPU or CPU data.

Returns

Pointer to a read-only mxGPUArray object.

Description

mxGPUCreateFromMxArray produces a read-only mxGPUArray object from an mxArray.

• If the input mxArray contains a gpuArray, this function extracts a reference to the GPU data from an mxArray passed as an input to the function.

• If the input mxArray contains CPU data, the data is copied to the GPU, but the returned object is still read-only.

If you need a writable copy of the array, use mxGPUCopyFromMxArray instead.

When you are done with the mxGPUArray object, use the mxGPUDestroyGPUArray function to delete it.

Version History

Introduced in R2013a