DioEchoBackMultiByte

機能

出力ポートの状態を複数ポート入力します。

書式

Ret = DioEchoBackMultiByte ( 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) ]
出力データを格納する配列の先頭アドレスを指定します。出力データは16進数で0HからFFHまでが返ります。

戻り値

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で指定した論理ポートの順番にデータが格納されます。
出力データは16進数で0HからFFHまでが返ります。
出力されている内容をモニタする場合に使用します。

使用例

C	Ret = DioEchoBackMultiByte(Id, &PortNo[0], PortNum, &Data[0]);
Python	Ret = cdio.DioEchoBackMultiByte(Id, PortNo, PortNum, Data)