YduRlyOutputStatus¶
機能¶
任意の点数のリレー出力状態を読み込みます。
現在のリレー出力の状態を知りたい場合に使用します。
書式¶
INT YduRlyOutputStatus(
WORD wUnitID,
PBYTE pbyData,
WORD wStart,
WORD wCount
);
パラメータ¶
wUnitID¶
出力読み込みをおこなうユニットのID番号を指定します。
言語 | C/C++ | C++/CLI | C# | VB(.NET2002以降) | VB6.0/VBA | GCC |
---|---|---|---|---|---|---|
型 | WORD | unsigned short | ushort | Short | Integer | uint16_t |
pbyData¶
出力データを格納するバッファへのポインタを指定します。
関数が正常に実行されると、出力データが格納されます。
出力データ | 状態 |
---|---|
0 | OFF |
1 | ON |
言語 | C/C++ | C++/CLI | C# | VB(.NET2002以降) | VB6.0/VBA | GCC |
---|---|---|---|---|---|---|
型 | PBYTE | unsigned char* | byte | Byte | Byte | uint8_t* |
wStart¶
出力の読み込みを開始するリレー番号(1~)から1引いた値(0~)を指定します。
言語 | C/C++ | C++/CLI | C# | VB(.NET2002以降) | VB6.0/VBA | GCC |
---|---|---|---|---|---|---|
型 | WORD | unsigned short | ushort | Short | Integer | uint16_t |
wCount¶
出力の読み込みをおこなうリレーの数を指定します。
言語 | C/C++ | C++/CLI | C# | VB(.NET2002以降) | VB6.0/VBA | GCC |
---|---|---|---|---|---|---|
型 | WORD | unsigned short | ushort | Short | Integer | uint16_t |
戻り値¶
関数が正常に終了した場合は0(YDU_RESULT_SUCCESS)が返ります。
正常に終了しなかった場合は0以外が返りますので、その場合はエラーコードを参照してください。
言語 | C/C++ | C++/CLI | C# | VB(.NET2002以降) | VB6.0/VBA | GCC |
---|---|---|---|---|---|---|
型 | INT | int | int | Integer | Long | int32_t |
使用例¶
-
例1
ユニットIDが0のユニットのRY1からRY8の出力状態を読み込みます。
データはRY1から順にデータバッファへ格納されます。 -
例2
ユニットIDが0のユニットのRY6からRY8の出力状態を読み込みます。
データはRY6から順にデータバッファへ格納されます。
C/C++¶
// 例1
int nResult;
BYTE abyData[8];
nResult = YduRlyOutputStatus(0, abyData, 0, 8);
// 例2
int nResult;
BYTE abyData[3];
nResult = YduRlyOutputStatus(0, abyData, 5, 3);
C++/CLI¶
// 例1
int result;
unsigned char outputStatus[8];
result = YduRlyOutputStatus(0, outputStatus, 0, 8);
// 例2
int result;
unsigned char outputStatus[3];
result = YduRlyOutputStatus(0, outputStatus, 5, 3);
C#¶
// 例1
int result;
byte[] outputStatus = new byte[8];
result = YduRly.OutputStatus(0, outputStatus, 0, 8);
// 例2
int result;
byte[] outputStatus = new byte[3];
result = YduRly.OutputStatus(0, outputStatus, 5, 3);
VB(.NET2002以降)¶
' 例1
Dim result As Integer
Dim outputStatus(7) As Byte
result = YduRlyOutputStatus(0, outputStatus, 0, 8)
' 例2
Dim result As Integer
Dim outputStatus(2) As Byte
result = YduRlyOutputStatus(0, outputStatus, 5, 3)
VB6.0/VBA¶
' 例1
Dim lngResult As Long
Dim bytData(7) As Byte
lngResult = YduRlyOutputStatus(0, bytData(0), 0, 8)
' 例2
Dim lngResult As Long
Dim bytData(2) As Byte
lngResult = YduRlyOutputStatus(0, bytData(0), 5, 3)
GCC¶
// 例1
int32_t result;
uint8_t output_status[8];
result = YduRlyOutputStatus(0, output_status, 0, 8);
// 例2
int32_t result;
uint8_t output_status[3];
result = YduRlyOutputStatus(0, output_status, 5, 3);