RequestFactory.CreateLargeReadRequest (METH)¶

METHOD CreateLargeReadRequest : IDatasources.IDriverLargeRequest

Creates a request representing the read operation for the given list of items. The request may stay alive until the list of items changes. That means it might be issued in several calls to |IDriverStateMachine.SendRequest| When the request is no longer necessary, it will be released by a call to |IDriverRequestFactory.ReleaseRequest| In contrast to |IDriverRequestFactory.CreateReadRequest|, the resulting request might require being sent using several calls to |IDriverStateMachine.SendRequest| for completion.

Important

The items may be stored as part of the request object. Nevertheless it is not allowed to access them from other threads because the list might change within the main datasources task. The list will not change as long as this object is alive.

InOut:

Scope	Name	Type	Comment
Return	`CreateLargeReadRequest`	`IDatasources.IDriverLargeRequest`	A new request object representing the read operation for the given list of items.
Input	`pItems`	POINTER TO IDatasources.IDataItem	A pointer to an array of \|IDataItem\| instances that should be monitored.
Input	`itemsCount`	`DINT`	The number of items within the array.