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