◆ BulkData() [2/5]

drama::BulkData::BulkData	(	std::weak_ptr< Task >	theTask,
		long	Size,
		ShareType	type = `ShareType::Create`,
		bool	Create = `true`,
		bool	DeleteOnDestruct = `true`,
		void *	Address = `nullptr`,
		const std::string &	Name = `""`,
		int	Key = `0`
	)

Define a bulk data shared memory segment of the specified type for use with DRAMA 2 methods which can send bulk data.

The parameters for this routine are used quite differently in the different systems for which DRAMA is implemented, and these system dependent details are described in more detail below.

Parameters

theTask	The DRAMA Task we are part of. This is passed by pointer, but BulkData is not taking ownership of the subject object, which must continue to exist until the BulkData object is destroyed.
Size	The size of the segment in bytes
type	The type of the shared memory item. See class description for more details.
Create	If true, the memory section does not actually exist and this routine is to create it.
DeleteOnDestruct	If set true, then the shared memory segment will be deleted when the BulkData item destructor is invoked.
Address	On systems with global address spaces, eg. VxWorks, the address of the memory is enough to specify it completely - together with its size. In any case, if the section is already mapped, this argument must specify the address at which it is mapped. If the section is created by this routine, it will ignored.
Name	Used to identify the mapped section on some machines. On UNIX, for example, if mapped files are used, this is the file name in question. If Name is not actually used on the current system it should be passed as an empty string.
Key	On some systems, this is an alternative way of specifying the mapped section. For example, if System V shared memory is used under UNIX, this is the identifier for that shared memory.