vslSaveStreamM
vslSaveStreamM
Writes random stream descriptive data, including
stream state, to a memory buffer.
Syntax
errstatus
=
vslSaveStreamM
(
stream
,
memptr
);
Include Files
- mkl.h
Input Parameters
Name | Type | Description |
|---|---|---|
stream | const VSLStreamStatePtr | Random stream to be written to the
memory |
memptr |
char* | Memory buffer to save random stream
descriptive data to |
Output
Parameters
Name | Type | Description |
|---|---|---|
errstatus | int | Error status of the operation |
Description
The
vslSaveStreamM
function writes the random stream
descriptive data, including the stream state, to the memory at
memptr
. Random stream stream
must be a valid stream created by vslNewStream
-like or vslCopyStream
-like service routines. The memptr
parameter must be a valid pointer to the memory of size sufficient
to hold the random stream stream
.
Use the service routine vslGetStreamSize
to determine this amount of memory.If the stream cannot be saved to the memory,
errstatus
has a non-zero value. The random stream can be read from the memory
pointed by memptr
using the vslLoadStreamM
function.Return Values
- VSL_ERROR_OK, VSL_STATUS_OK
- Indicates no error, execution is successful.
- VSL_ERROR_NULL_PTR
- Eithermemptrorstreamis aNULLpointer.
- VSL_RNG_ERROR_BAD_STREAM
- streamis aNULLpointer.