コンテンツにスキップ
関数 > デジタル入出力 >

YdciDioOutputStatus

機能

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

適用

DIO-8/8B-UBC、DIO-8/8B-UBT

書式

INT YdciDioOutputStatus(
    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

出力の読み込みを開始する出力番号(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
    OUT0からOUT7の出力状態を読み込みます。データはOUT0から順にデータバッファへ格納されます。

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

C/C++

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

// 例2
int nResult;
BYTE abyData[3];
nResult = YdciDioOutputStatus(wID, abyData, 5, 3);

C++/CLI

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

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

C#

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

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

VB(.NET2002以降)

' 例1
Dim result As Integer
Dim outputStatus(7) As Byte
result = YdciDioOutputStatus(id, outputStatus, 0, 8)

' 例2
Dim result As Integer
Dim outputStatus(2) As Byte
result = YdciDioOutputStatus(id, outputStatus, 5, 3)

VB6.0/VBA

' 例1
Dim lngResult As Long
Dim bytData(7) As Byte
lngResult = YdciDioOutputStatus(intID, bytData(0), 0, 8)

' 例2
Dim lngResult As Long
Dim bytData(2) As Byte
lngResult = YdciDioOutputStatus(intID, bytData(0), 5, 3)

GCC

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

// 例2
int32_t result;
uint8_t output_status[3];
result = YdciDioOutputStatus(id, output_status, 5, 3);