コンテンツにスキップ
関数 > リレー出力 >

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);