機能
入力ポートから1バイト(8ビット)入力します。
書式
Ret = DioInpByte ( Id , PortNo , &Data )
引数
Id
[ C： short ] [ Python: ctypes.c_short ]
DioInitで取得したデバイスIDを指定します。
PortNo
[ C： short ] [ Python: ctypes.c_short ]
入力論理ポート番号を指定します。入力論理ポート番号は、デバイスの入力ポートの先頭を0として最後の入力ポートまで、連続で付けられた番号です。
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 |
ポート番号が指定可能範囲を超えています。 |
その他のエラー（参照：エラーコード詳細）
初期値
入力データの初期値は、外部機器がつながっていない状態では0です。
説明
入力ポートから1バイト(8ビット)入力します。必要なビットの情報を得るには、各言語のビット演算子を用いて取り出してください。
ワイヤレスI/Oデバイスの場合、親機に保存されている子機のデータを取得します。
子機のリアルタイム情報ではないことにご注意ください。
子機のリアルタイム情報を取得する場合はDioInpByteSR関数をご使用ください。
使用例
C |
Ret = DioInpByte(Id,
PortNo, &Data); |
Python |
Ret = cdio.DioInpByte(Id,
PortNo, ctypes.byref(Data)) |
関連項目
DioInpBit DioInpMultiByte DioInpMultiBit 論理ポート