関数 > リレー出力 >

YdciRlyOutputStatus

機能

任意の点数のリレー出力状態を読み込みます。
現在のリレー出力の状態を知りたい場合に使用します。

適用

RLY-P4/2/0B-UBT

書式

INT YdciRlyOutputStatus(
    WORD wID,
    PBYTE pbyData,
    WORD wStart,
    WORD wCount
);

パラメータ

wID

YdciOpen関数で取得したIDを指定します。

言語 C/C++ C++/CLI C# VB(.NET2002以降) VB6.0 GCC
WORD unsigned short ushort Short Integer uint16_t

pbyData

出力データを格納するバッファへのポインタを指定します。
関数が正常に実行されると、出力データが格納されます。

出力データ 状態
0 OFF
1 ON
言語 C/C++ C++/CLI C# VB(.NET2002以降) VB6.0 GCC
PBYTE unsigned char* byte Byte Byte uint8_t*

wStart

出力の読み込みを開始するリレー番号(1~)から1引いた値(0~)を指定します。

言語 C/C++ C++/CLI C# VB(.NET2002以降) VB6.0 GCC
WORD unsigned short ushort Short Integer uint16_t

wCount

出力の読み込みをおこなうリレーの数を指定します。

言語 C/C++ C++/CLI C# VB(.NET2002以降) VB6.0 GCC
WORD unsigned short ushort Short Integer uint16_t

戻り値

関数が正常に終了した場合は0(YDCI_RESULT_SUCCESS)が返ります。
正常に終了しなかった場合は0以外が返りますので、その場合はエラーコードを参照してください。

言語 C/C++ C++/CLI C# VB(.NET2002以降) VB6.0 GCC
INT int int Integer Long int32_t

使用例

  • 例1
    RY1からRY4の出力状態を読み込みます。データはRY1から順にデータバッファへ格納されます。

  • 例2
    RY3からRY4の出力状態を読み込みます。データはRY3から順にデータバッファへ格納されます。

C/C++

// 例1
int nResult;
BYTE abyData[4];
nResult = YdciRlyOutputStatus(wID, abyData, 0, 4);

// 例2
int nResult;
BYTE abyData[2];
nResult = YdciRlyOutputStatus(wID, abyData, 2, 2);

C++/CLI

// 例1
int result;
unsigned char outputStatus[4];
result = YdciRlyOutputStatus(id, outputStatus, 0, 4);

// 例2
int result;
unsigned char outputStatus[2];
result = YdciRlyOutputStatus(id, outputStatus, 2, 2);

C#

// 例1
int result;
byte[] outputStatus = new byte[4];
result = Ydci.RlyOutputStatus(id, outputStatus, 0, 4);

// 例2
int result;
byte[] outputStatus = new byte[2];
result = Ydci.RlyOutputStatus(id, outputStatus, 2, 2);

VB(.NET2002以降)

' 例1
Dim result As Integer
Dim outputStatus(3) As Byte
result = YdciRlyOutputStatus(id, outputStatus, 0, 4)

' 例2
Dim result As Integer
Dim outputStatus(1) As Byte
result = YdciRlyOutputStatus(id, outputStatus, 2, 2)

VB6.0

' 例1
Dim lngResult As Long
Dim bytData(3) As Byte
lngResult = YdciRlyOutputStatus(intID, bytData(0), 0, 4)

' 例2
Dim lngResult As Long
Dim bytData(1) As Byte
lngResult = YdciRlyOutputStatus(intID, bytData(0), 2, 2)

GCC

// 例1
int32_t result;
uint8_t output_status[4];
result = YdciRlyOutputStatus(id, output_status, 0, 4);

// 例2
int32_t result;
uint8_t output_status[2];
result = YdciRlyOutputStatus(id, output_status, 2, 2);