DioInpBit


機能

入力ポートから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 論理ビット