IDriverRequestFactoryLargeRequests.CreateLargeReadRequest (METH)¶

METHOD CreateLargeReadRequest : 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`	IDriverLargeRequest	A new request object representing the read operation for the given list of items.
Input	`pItems`	POINTER TO IDataItem	A pointer to an array of IDataItem instances that should be monitored.
Input	`itemsCount`	`DINT`	The number of items within the array.