DioNotifyInterrupt

Function

Sets interrupt event factor.

Format

Ret = DioNotifyInterrupt ( Id , BitNo , Logic , hWnd )

Parameters

Id [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Specify the device ID retrieved from DioInit.

BitNo [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Specify logical input bit number. This bit number must be a bit available for interrupt on the hardware.

Logic [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Specify the interrupt logic by one of the following defined values.

hWnd [ VB.NET: IntPtr ] [ C, C++: HWND ] [ C#: IntPtr ] [ Python: ctypes.wintypes.HANDLE ]
Specifies the window handle to receive the trigger message.
The window handle can be retrieved by m_hWnd in VC.
Specify it to 0 when you want to use callback function but not window message.

Return Value

Ret [ VB.NET: Integer ] [ C, C++: long ] [ C#: int ] [ Python: ctypes.c_long ]

The others (See also: Details of Error Code)

Initial Value

The interrupt is masked.

Remarks

Specifies interrupt event to star or stop. The interrupt is the function that can detect rising edge or falling edge of input bit on the hardware and give notification.

The position and the number of input bits available for interrupt vary with the device. Refer to the hardware specifications of each device for details. Moreover, the interrupt logic is either the value of rising edge and falling edge.

Software parameters of DIO_INT_RISE and DIO_INT_FALL indicate input values of 0->1 and 1->0 respectively. Please note that for voltage level, the rising edge and falling edge are different depending on that the board is positive logic or negative logic.

The message ID is defined with DIOM_INTERRUPT = 1300H. When the interrupt occurs, the DIOM_INTERRUPT message is posted to the specified window handle through the PostMessage function.

LOWORD(wParam)=ID retrieved from DioInit
LOWORD(lParam)=Interrupt bit number
HIWORD(lParam)=Rising edge: 1, Falling edge: 2
* HIWORD indicates the high-order word. LOWORD indicates the low-order word.

For USB devices, only one process can accept interrupt events.
The message cannot be sent from the same device to two or more processes.
To use this function, hardware should support interrupt.

For details about message handling, please refer to the sample programs of each language.
To enable the interrupt for more than one bit, call this function for each corresponding bit.

For Ethernet devices
    If communication with the device is lost, the process will be unregistered and will no longer receive event notifications.
    If you want to perform event notification again, please make the settings again using this function.

     You can check the registration status of the current process using the DioGetNetCommunicationInfo function.

Example

Monitors the input change of 0->1 for logical bit 0.

See Also

DioGetNetCommunicationInfo