DioInpByte


機能

入力ポートから1バイト(8ビット)入力します。

書式

Ret = DioInpByte ( Id , PortNo , Data )

引数

Id [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
DioInitで取得したデバイスIDを指定します。

PortNo [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
入力論理ポート番号を指定します。入力論理ポート番号は、デバイスの入力ポートの先頭を0として最後の入力ポートまで、連続で付けられた番号です。

Data [ VB.NET: Byte ] [ C, C++: BYTE * ] [ C#: out byte ] [ Python: ctypes.POINTER(ctypes.c_ubyte) ]
入力データを格納する変数のアドレスを指定します。

戻り値

Ret [ VB.NET: Integer ] [ C, C++: long ] [ C#: int ] [ Python: ctypes.c_long ]

定義

[Dec]

意味

DIO_ERR_SUCCESS

0

正常終了

DIO_ERR_SYS_RECOVERED_FROM_STANDBY

7

スタンバイモードから復帰したため、DioResetDevice関数を実行してください

DIO_ERR_DLL_INVALID_ID

10001

無効なIDが指定されました。

DIO_ERR_DLL_CALL_DRIVER

10002

ドライバーを呼び出せません(デバイスI/Oコントロールに失敗)。

DIO_ERR_DLL_BUFF_ADDRESS

10100

データバッファアドレスが不正です。

DIO_ERR_SYS_NOT_SUPPORTED

20001

このデバイスではこの関数は使用できません。

DIO_ERR_SYS_PORT_NO

20100

ポート番号が指定可能範囲を超えています。

その他のエラー(参照:エラーコード詳細

初期値

入力データの初期値は、外部機器がつながっていない状態では0です。

説明

入力ポートから1バイト(8ビット)入力します。必要なビットの情報を得るには、各言語のビット演算子を用いて取り出してください。

ワイヤレスI/Oデバイスの場合、親機に保存されている子機のデータを取得します。
子機のリアルタイム情報ではないことにご注意ください。
子機のリアルタイム情報を取得する場合はDioInpByteSR関数をご使用ください。

使用例

ポート0からデータを入力します。

VB.NET

Dim Ret As Integer
Dim Data As Byte
Ret = DioInpByte ( Id , 0 , Data )
 

C, C++

long Ret;
BYTE Data;
Ret = DioInpByte ( Id , 0 , &Data );
 

C#

int Ret;
byte Data;
Ret = dio.InpByte ( Id , 0 , out Data );
 

Python

Ret = ctypes.c_long()
Data = ctypes.c_ubyte()
Ret.value = cdio.DioInpByte ( Id , 0 , ctypes.byref(Data) )
 

関連項目

DioInpBit DioInpMultiByte DioInpMultiBit