1.7.1. DLN_REGISTER_NOTIFICATION

DLN_REGISTER_NOTIFICATION Command

Go to response

The DLN_REGISTER_NOTIFICATION command registers notification settings.

  typedef struct
   {
      DLN_MSG_HEADER header;
      DLN_NOTIFICATION notification;
   } __PACKED_ATTR DLN_REGISTER_NOTIFICATION_CMD;

Parameters:

header
Defines the DLN message header DLN_MSG_HEADER. The header contains several predefined fields and is used to identify and route messages. When sending the command, a user must fill the following fields:

  • size - The size of the message. Must be equal to the size of the DLN_REGISTER_NOTIFICATION_CMD structure.
  • msgId - Defines the message. For the DLN_REGISTER_NOTIFICATION command, it must be set to 0x0000. You can use the DLN_MSG_ID_REGISTER_NOTIFICATION constant.
  • echoCounter - Can be used to link a command to a response. The response will have the same echoCounter value. This field can be any numerical value from 0 to 0xFFFF (65535).
  • handle - A handle to the DLN-series adapter. You may specify either a handle to a specific device (stream) or the HDLN_ALL_DEVICES value.
notification
Defines the notification settings. See DLN_NOTIFICATION structure for additional info.

DLN_REGISTER_NOTIFICATION Response

Go to command

The adapter sends the DLN_REGISTER_NOTIFICATION response after the command execution. The response will notify you whether the settings were successfully registered.

  typedef struct
   {
      DLN_MSG_HEADER header;
      DLN_RESULT result;
   } __PACKED_ATTR DLN_REGISTER_NOTIFICATION_RSP;

Parameters:

header
Defines the DLN message header DLN_MSG_HEADER. The response header contains the following fields:
  • size - The size of the message. It is equal to the size of the DLN_REGISTER_NOTIFICATION_RSP structure.
  • msgId - Defines the message. For the DLN_REGISTER_NOTIFICATION response it is set to 0x0000. The DLN_MSG_ID_REGISTER_NOTIFICATION constant can be used.
  • echoCounter - Links a command to a response. The echoCounter value is copied from the respective command header.
  • handle - A handle to the DLN-series adapter. Can be either a handle to a specific device (stream) or the HDLN_ALL_DEVICES value.
result
Contains the result of the command execution. The following values are available: