DioResetDeviceEx

Function

Resets a device with the specified mode.

Format

Ret = DioResetDeviceEx ( Id , ResetMode )

Parameters

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

ResetMode [ VB.NET： UInteger ] [ C, C++： unsigned long ] [ C#： uint ] [ Python: ctypes. c_uint ]
Specify the mode to reset.

Definition

Value

[Dec]

Description

DIO_RESET_MODE_NORMAL

Normal reset (same as DioResetDevice)

DIO_RESET_MODE_FORCE

Force reset

Return Value

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

Definition	Value [Dec]	Description
DIO_ERR_SUCCESS	0	Normal completed.
DIO_ERR_DLL_INVALID_ID	10001	Invalid ID specified.
DIO_ERR_DLL_CALL_DRIVER	10002	Not call the driver (Failure on DEVICE I/O CONTROL).
DIO_ERR_SYS_MEMORY	20000	Not secure memory.
DIO_ERR_SYS_USING_OTHER_PROCESS	20003	Other process is using the device, not execute.
DIO_ERR_SYS_RESET_MODE	20005	The reset mode is outside the specifiable range.

The others (See also: Details of Error Code)

Initial Value

None

Remarks

Outputs the reset command to a device, and all driver parameters return to the initial values.

On Normal Reset mode, this function cannot be used during the another process is using the device (ex. DioNotifyInterrupt, DioNotifyTrg in operation).

On Force Reset mode, this function can be used even though another process is using the device.
In this case, the operation of the device stops.

Specifications based on devices

DIO-0808RN-USB	All of the status of output ports are 1.
Devices other than the above	All of the status of output ports are 0.

Example

Performs the reset with force reset mode.

VB.NET	Dim Ret As Integer Ret = DioResetDeviceEx ( Id , DIO_RESET_MODE_FORCE )
C, C++	long Ret; Ret = DioResetDeviceEx ( Id , DIO_RESET_MODE_FORCE );
C#	int Ret; Ret = dio.ResetDeviceEx ( Id , CdioConst.DIO_RESET_MODE_FORCE );
Python	Ret = ctypes.c_long() Ret.value = cdio.DioResetDeviceEx ( Id , cdio.DIO_RESET_MODE_FORCE )