CreateMessage (FUN)¶

FUNCTION CreateMessage : CAA.HANDLE

This function allocates a new message from the data pool of the driver and makes it available via its handle hMessage. In addition, the function sets the identifier, cobld, data length and RTR flag of the message. Such a message must either be sent with Write or released with FreeMessage. It can also be duplicated by use of CloneMessage.

Example

See Write.

InOut:

Scope	Name	Type	Comment
Return	`CreateMessage`	`CAA.HANDLE`	new message handle or `CAA.gc_hINVALID` if no resources left
Input	`hDriver`	`CAA.HANDLE`	handle of CAN interface
	`cobID`	`CL2I.COBID`	cob ID
	`usiLength`	`USINT`	length of valid data bytes
	`xRTR`	`BOOL`	RTR bit
	`x29BitID`	`BOOL`	29 Bit ID
	`peError`	POINTER TO ERROR	optional pointer to error enum