RequestFactory.CreateReadRequest (METH)ΒΆ

METHOD CreateReadRequest : IDatasources.IDriverRequest

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|

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

CreateReadRequest

IDatasources.IDriverRequest

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.

itemsCount

DINT

The number of items within the array.