関数 > リレー出力 >

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/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（YDCI_RESULT_SUCCESS）が返ります。
正常に終了しなかった場合は0以外が返りますので、その場合はエラーコードを参照してください。

言語	C/C++	C++/CLI	C#	VB（.NET2002以降）	VB6.0/VBA	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/VBA¶

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