EdsStreamMBS.Constructor(data as string)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Creates a stream from the memory buffer you prepared.

Unlike the buffer size of streams created by means of EdsCreateMemoryStream, the buffer size you prepare for streams created this way does not expand.
Lasterror is set.

See also:

• Constructor(Memory as Memoryblock, size as Int64 = -1, offset as Integer = 0)
• Constructor(path as folderitem, CreateDisposition as Integer, DesiredAccess as Integer)
• Constructor(path as string, CreateDisposition as Integer, DesiredAccess as Integer)
• Constructor(size as UInt64)

EdsStreamMBS.Constructor(Memory as Memoryblock, size as Int64 = -1, offset as Integer = 0)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Creates a stream from the memory buffer you prepare.

Unlike the buffer size of streams created by means of CreateMemoryStream, the buffer size you prepare for streams created this way does not expand.
Lasterror is set.

See also:

• Constructor(data as string)
• Constructor(path as folderitem, CreateDisposition as Integer, DesiredAccess as Integer)
• Constructor(path as string, CreateDisposition as Integer, DesiredAccess as Integer)
• Constructor(size as UInt64)

EdsStreamMBS.Constructor(path as folderitem, CreateDisposition as Integer, DesiredAccess as Integer)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Creates a new file on a host computer (or opens an existing file) and creates a file stream for access to the file.

If a new file is designated before executing this API, the file is actually created following the timing of writing by means of EdsWrite or the like with respect to an open stream.

path: Designate the file name of a new file or a file to open.
CreateDisposition: Designate how the file is handled (that is, its disposition) if it exists or does not exist. Designate a value defined in kEdsFileCreateDisposition*.
DesiredAccess: Pass kEdsAccess_Read, kEdsAccess_Write or kEdsAccess_ReadWrite.
Lasterror is set.

See also:

• Constructor(data as string)
• Constructor(Memory as Memoryblock, size as Int64 = -1, offset as Integer = 0)
• Constructor(path as string, CreateDisposition as Integer, DesiredAccess as Integer)
• Constructor(size as UInt64)

EdsStreamMBS.Constructor(path as string, CreateDisposition as Integer, DesiredAccess as Integer)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Creates a new file on a host computer (or opens an existing file) and creates a file stream for access to the file.

If a new file is designated before executing this API, the file is actually created following the timing of writing by means of EdsWrite or the like with respect to an open stream.

path: Designate the file name of a new file or a file to open.
CreateDisposition: Designate how the file is handled (that is, its disposition) if it exists or does not exist. Designate a value defined in kEdsFileCreateDisposition*.
DesiredAccess: Pass kEdsAccess_Read, kEdsAccess_Write or kEdsAccess_ReadWrite.
Lasterror is set.

See also:

• Constructor(data as string)
• Constructor(Memory as Memoryblock, size as Int64 = -1, offset as Integer = 0)
• Constructor(path as folderitem, CreateDisposition as Integer, DesiredAccess as Integer)
• Constructor(size as UInt64)

EdsStreamMBS.Constructor(size as UInt64)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Creates a stream in the memory of a host computer.

In the case of writing in excess of the allocated buffer size, the memory is automatically extended.
Lasterror is set.

See also:

• Constructor(data as string)
• Constructor(Memory as Memoryblock, size as Int64 = -1, offset as Integer = 0)
• Constructor(path as folderitem, CreateDisposition as Integer, DesiredAccess as Integer)
• Constructor(path as string, CreateDisposition as Integer, DesiredAccess as Integer)

EdsStreamMBS.CopyData(WriteSize as UInt64, outStream as EdsStreamMBS)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Copies data from the copy source stream to the copy destination stream.

The read or write position of the data to copy is determined from the current file read or write position of the respective stream.
After this API is executed, the read or write positions of the copy source and copy destination streams are moved an amount corresponding to WriteSize in the positive direction.
Lasterror is set.

EdsStreamMBS.CreateEvfImageRef as EdsEvfImageMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Creates an object used to get the live view image data set.

Lasterror is set.
See EdsCreateEvfImageRef in the SDK documentation.

EdsStreamMBS.CreateImage as EdsImageMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Creates an image object from an image file.

Without modification, stream objects cannot be worked with as images. Thus, when extracting images from image files, you must use this API to create image objects.
The image object created this way can be used to get image information (such as the height and width, number of color components, and resolution), thumbnail image data, and the image data itself.
Lasterror is set.

EdsStreamMBS.Length as UInt64

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Gets the stream size.

Returns the number of bytes of the stream.
Lasterror is set.

EdsStreamMBS.Pointer as Ptr

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Gets the pointer to the start address of memory managed by the memory stream.

As the EDSDK automatically resizes the buffer, the memory stream provides you with the same access methods as for the file stream. If access is attempted that is excessive with regard to the buffer size for the stream, data before the required buffer size is allocated is copied internally, and new writing occurs. Thus, the buffer pointer might be switched on an unknown timing. Caution in use is therefore advised.

Lasterror is set.

Some examples using this method:

• /Cameras/CanonEOSDigital/Example

EdsStreamMBS.Position as UInt64

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Gets the current read or write position of the stream (that is, the file position indicator).

Returns the current read or write position of the stream (that is, to the offset position from the beginning of the stream). (The beginning of the stream is 0.)
Lasterror is set.

The stream's initial read or write position is 0. If Write or Read is used to write or read from the stream, the indicator is moved an amount corresponding to that size in the positive direction.
When intentionally changing the read or write position of the stream, use Seek.

EdsStreamMBS.Read(size as UInt64) as string

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Reads data with given maximum lenegth into the buffer, starting at the current read or write position of the stream.

The size of data actually read can be slower.
Lasterror is set.

EdsStreamMBS.Seek(Offset as Int64, origin as Integer)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Moves the read or write position of the stream (that is, the file position indicator).

Offset: Designate the number of bytes to move the file position indicator.
Origin: Designate the origin for moving from the read or write position. Designate any of the following, as defined in constant kEdsSeek*.
Lasterror is set.

EdsStreamMBS.Write(Data as string) as UInt64

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Canon EOS Digital	MBS Cameras Plugin	12.1	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop only

Writes data of a designated buffer to the current read or write position of the stream.

Lasterror is set.
Returns number of bytes written.