IDriverRequestFactory.CreateReadRequest (METH) ¶ METHOD CreateReadRequest : 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 IDriverRequest 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. itemsCount DINT The number of items within the array.

IDriverRequestFactory.CreateWriteRequest (METH) ¶ METHOD CreateWriteRequest : IDriverRequest Creates a request representing a write operation for the given list of items. When the request is no longer necessary, it will be released by a call to IDriverRequestFactory.ReleaseRequest Important The passed list of items must not be stored as part of the request. InOut: Scope Name Type Comment Return CreateWriteRequest IDriverRequest A new request object representing a write operation for the given list of items. Input pItems POINTER TO IDataItem A pointer to an array of IDataItem instances that should be written. itemsCount DINT The number of items within the array.

IDriverRequestFactory.ReleaseRequest (METH) ¶ METHOD ReleaseRequest Releases the given request object. Note This method might be called while a request is still active in case the list of items is changed while a request is on it’s way. InOut: Scope Name Type Comment Input request IDriverRequest The request that should be released. The object will no longer be accessed after this call.

IDriverRequestFactoryCustom (ITF) ¶ INTERFACE IDriverRequestFactoryCustom EXTENDS IDriverRequestFactory Methods: CreateCustomRequest CreateReadRequest , inherited from IDriverRequestFactory CreateWriteRequest , inherited from IDriverRequestFactory ReleaseRequest , inherited from IDriverRequestFactory Structure: CreateCustomRequest (Method)

IDriverRequestFactoryCustom.CreateCustomRequest (METH) ¶ METHOD CreateCustomRequest : IDriverCustomRequest InOut: Scope Name Type Return CreateCustomRequest IDriverCustomRequest Input request ICustomRequest

IDriverRequestFactoryLargeRequests (ITF) ¶ INTERFACE IDriverRequestFactoryLargeRequests EXTENDS IDriverRequestFactory This interface can additionally be implemented by function blocks implementing IDriverRequestFactory to support reading/writing of possibly large requests that might require multiple requests. Note This feature is typically necessary for successfully reading/writing recipes Methods: CreateLargeReadRequest CreateLargeWriteRequest CreateReadRequest , inherited from IDriverRequestFactory CreateWriteRequest , inherited from IDriverRequestFactory ReleaseRequest , inherited from IDriverRequestFactory Structure: CreateLargeReadRequest (Method) CreateLargeWriteRequest (Method)

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. itemsCount DINT The number of items within the array.

IDriverRequestFactoryLargeRequests.CreateLargeWriteRequest (METH) ¶ METHOD CreateLargeWriteRequest : IDriverLargeRequest Creates a request representing a write operation for the given list of items. When the request is no longer necessary, it will be released by a call to IDriverRequestFactory.ReleaseRequest In contrast to IDriverRequestFactory.CreateWriteRequest , the resulting request might require being sent using several calls to IDriverStateMachine.SendRequest for completion. Important The passed list of items must not be stored as part of the request. InOut: Scope Name Type Comment Return CreateLargeWriteRequest IDriverLargeRequest A new request object representing a write operation for the given list of items. Input pItems POINTER TO IDataItem A pointer to an array of IDataItem instances that should be written. itemsCount DINT The number of items within the array.

IDriverRequestFactoryReusable (ITF) ¶ INTERFACE IDriverRequestFactoryReusable EXTENDS IDriverRequestFactory Implementations of this interface support the creation of request objects that can be reused for issuing several read or write requests using the same object. Note The idea behind this interface is to being able to preregister a list of variables (a request from the driver’s point of view) within the connected device for quicker response times when it comes to reading/writing because symbolic resolutions etc. can be done before. Properties: ReusableRequestsSupported Methods: CreateReusableRequest CreateReadRequest , inherited from IDriverRequestFactory CreateWriteRequest , inherited from IDriverRequestFactory ReleaseRequest , inherited from IDriverRequestFactory Structure: CreateReusableRequest (Method) ReusableRequestsSupported (Property)

IDriverRequestFactoryReusable.CreateReusableRequest (METH) ¶ METHOD CreateReusableRequest : IDriverRequestReusable Creates a request representing a read or write operation for the given list of items. The request may stay alive until it is released. From the driver’s point of view the request can live as long as the connection to the connected device is alive. For the user of this request, this means that 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 InOut: Scope Name Type Comment Return CreateReusableRequest IDriverRequestReusable A new request object representing the read or write operation for the given list of items. Input pItems POINTER TO IDataItem A pointer to an array of IDataItem instances that should be written. itemsCount DINT The number of items within the array.