機能
入力ポートから複数バイト入力します。
書式
Ret = DioInpMultiByte ( Id , &PortNo[0] , PortNum , &Data[0] )
引数
Id
[ C： short ] [ Python: ctypes.c_short ]
DioInitで取得したデバイスIDを指定します。
PortNo
[ C： short * ] [ Python: ctypes.POINTER(ctypes.c_short) ]
入力論理ポート番号を配列に入れて、その配列の先頭アドレスを指定します。
PortNum
[ C： short ] [ Python: ctypes.c_short ]
PortNoで指定したポート数を指定します。ポート数の最大値は256です。
Data
[ C:unsigned char *] [ Python: ctypes.POINTER(ctypes.c_ubyte) ]
入力データを格納する配列の先頭アドレスを指定します。
戻り値
Ret [C： long ] [ Python: ctypes.c_long ]
定義 |
値 [Dec] |
意味 |
DIO_ERR_SUCCESS |
0 |
正常終了 |
DIO_ERR_DLL_INVALID_ID |
10001 |
無効なIDが指定されました。 |
DIO_ERR_DLL_CALL_DRIVER |
10002 |
ドライバを呼び出せません(ioctlに失敗)。 |
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関数をご使用ください。
使用例
C |
Ret = DioInpMultiByte(Id,
&PortNo[0], PortNum, &Data[0]); |
Python |
Ret = cdio.DioInpMultiByte(Id,
PortNo, PortNum, Data) |
関連項目
DioInpByte DioInpBit DioInpMultiBit 論理ポート