IAdsNotifications.AddDeviceNotificationExAsync Method (UInt32, UInt32, NotificationSettings, Object, Type, .Int32., CancellationToken)
Connects a variable to the ADS client asynchronously. The ADS client will be notified by the AdsNotificationEx event.
Namespace: TwinCAT.Ads
Assembly: TwinCAT.Ads.Abstractions (in
TwinCAT.Ads.Abstractions.dll) Version: 6.0.328+39e3229
Syntax
C#
Task<ResultHandle> AddDeviceNotificationExAsync(
uint indexGroup,
uint indexOffset,
NotificationSettings settings,
Object? userData,
Type type,
int[]? args,
CancellationToken cancel
)
Parameters
|
indexGroup |
Type: System.UInt32 |
|
indexOffset |
Type: System.UInt32 |
|
settings |
Type: TwinCAT.Ads.NotificationSettings |
|
userData |
Type: System.Object |
|
type |
Type: System.Type |
|
args |
Type: .System.Int32. |
|
cancel |
Type: System.Threading.CancellationToken |
Return Value
Type: Task.ResultHandle.
A task that represents the asynchronous
'AddDeviceNotification' operation. The ResultHandle type
parameter contains the created handle (Handle) and the
ErrorCode
after execution.
Remarks
If type is a string type, the first element of the parameter args specifies the number of characters of the string. If type is an array type, the number of elements for each dimension has to be specified in the parameter args. Only primitive types (AnyType) are supported by this method. Because notifications allocate TwinCAT system resources, a complementary call to DeleteDeviceNotificationAsync(UInt32, CancellationToken) should always called when the notification is not used anymore.