IAdsNotifications.AddDeviceNotification Method (UInt32, UInt32, AdsStream, Int32, Int32, AdsTransMode, Int32, Int32, Object)

Connects a variable to the ADS client. The ADS client will be notified by the AdsNotification event.

Namespace: TwinCAT.Ads
Assembly: TwinCAT.Ads (in TwinCAT.Ads.dll) Version: 4.3.0.0

Syntax

C#

int AddDeviceNotification(
    uint indexGroup,
    uint indexOffset,
    AdsStream dataStream,
    int offset,
    int length,
    AdsTransMode transMode,
    int cycleTime,
    int maxDelay,
    Object userData
)

VB

Function AddDeviceNotification ( 
    indexGroup As UInteger,
    indexOffset As UInteger,
    dataStream As AdsStream,
    offset As Integer,
    length As Integer,
    transMode As AdsTransMode,
    cycleTime As Integer,
    maxDelay As Integer,
    userData As Object
) As Integer

Parameters

indexGroup	Type: System.UInt32 Contains the index group number of the requested ADS service.
indexOffset	Type: System.UInt32 Contains the index offset number of the requested ADS service.
dataStream	Type: TwinCAT.Ads.AdsStream The stream that should receive the data.
offset	Type: System.Int32 Offset of the data in dataStream.
length	Type: System.Int32 Length of the data in dataStream.
transMode	Type: TwinCAT.Ads.AdsTransMode Specifies if the event should be fired cyclically or only if the variable has changed.
cycleTime	Type: System.Int32 The ADS server checks whether the variable has changed after this time interval. Unit is in ms.
maxDelay	Type: System.Int32 The AdsNotification event is fired at the latest when this time has elapsed. The unit is ms.
userData	Type: System.Object This object can be used to store user specific data.

Return Value

Type: Int32
The handle of the notification.

Exceptions

Exception	Condition
AdsErrorException	Thrown when the ADS call fails.

Reference

IAdsNotifications Interface

AddDeviceNotification Overload

TwinCAT.Ads Namespace