DioInpMultiByte

機能

入力ポートから複数バイト入力します。

Ret = DioInpMultiByte ( Id , PortNo , PortNum , Data )

Id [ VB.NET： Short ] [ C, C++： short ] [ C#： short ] [ Python: ctypes.c_short ]
DioInitで取得したデバイスIDを指定します。

PortNo [ VB.NET： Short ] [ C, C++： short * ] [ C#： out short ] [ Python: ctypes.POINTER(ctypes.c_short) ]
入力論理ポート番号を配列に入れて、その配列の先頭アドレスを指定します。

PortNum [ VB.NET： Short ] [ C, C++： short ] [ C#： short ] [ Python: ctypes.c_short ]
PortNoで指定したポート数を指定します。ポート数の最大値は256です。

Data [ VB.NET： Byte ] [ C, C++： BYTE * ] [ C#： out byte ] [ Python: ctypes.POINTER(ctypes.c_ubyte) ]
入力データを格納する配列の先頭アドレスを指定します。

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

定義	値 [Dec]	意味
DIO_ERR_SUCCESS	0	正常終了
DIO_ERR_SYS_RECOVERED_FROM_STANDBY	7	スタンバイモードから復帰したため、DioResetDevice関数を実行してください
DIO_ERR_DLL_INVALID_ID	10001	無効なIDが指定されました。
DIO_ERR_DLL_CALL_DRIVER	10002	ドライバーを呼び出せません(デバイスI/Oコントロールに失敗)。
DIO_ERR_DLL_BUFF_ADDRESS	10100	データバッファアドレスが不正です。
DIO_ERR_SYS_NOT_SUPPORTED	20001	このデバイスではこの関数は使用できません。
DIO_ERR_SYS_PORT_NO	20100	ポート番号が指定可能範囲を超えています。
DIO_ERR_SYS_PORT_NUM	20101	ポート数が指定可能範囲を超えています。

その他のエラー（参照：エラーコード詳細）

入力データの初期値は、外部機器がつながっていない状態では0です。

入力ポートから複数バイト入力します。この関数を呼び出す前に、PortNoで指定する配列に、入力したい論理ポート番号を設定しておく必要があります。配列Dataには、PortNoで指定した論理ポートの順番に入力データが格納されます。

ワイヤレスI/Oデバイスの場合、親機に保存されている子機のデータを取得します。
子機のリアルタイム情報ではないことにご注意ください。
子機のリアルタイム情報を取得する場合はDioInpMultiByteSR関数をご使用ください。

0,1ポートから入力します。

VB.NET	Dim Ret As Integer Dim PortNo(1) As Short Dim Data(1) As Byte PortNo(0) = 0 PortNo(1) = 1 Ret = DioInpMultiByte ( Id , PortNo , 2 , Data )
C, C++	long Ret; short PortNo[2] BYTE Data[2]; PortNo[0] = 0; PortNo[1] = 1; Ret = DioInpMultiByte ( Id , PortNo , 2 , Data );
C#	int Ret; short[] PortNo = new short[2]; byte[] Data = new byte[2]; PortNo[0] = 0; PortNo[1] = 1; Ret = dio.DioInpMultiByte ( Id , out PortNo , 2 , out Data );
Python	Ret = ctypes.c_long() PortNoType = ctypes.c_short * 2 PortNo = PortNoType() DataType = ctypes.c_ubyte * 2 Data = DataType() PortNo[0] = 0 PortNo[1] = 1 Ret.value = cdio.DioInpMultiByte ( Id , PortNo , 2 , Data )