38.9.4.1 リード / ライト関数

シングルハンドル系ダイレクトリードAPI

• ビットデータ

INT WINAPI ReadDeviceBit(LPCSTR sNodeName,LPCSTR sDeviceName,WORD* owData,WORD wCount);

• 16ビットデータ

INT WINAPI ReadDevice16(LPCSTR sNodeName,LPCSTR sDeviceName,WORD* owData,WORD wCount);

• 32ビットデータ

INT WINAPI ReadDevice32(LPCSTR sNodeName,LPCSTR sDeviceName,DWORD* odwData,WORD wCount);

• 16ビットBCDデータ

INT WINAPI ReadDeviceBCD16(LPCSTR sNodeName,LPCSTR sDeviceName,WORD* owData,WORD wCount);

• 32ビットBCDデータ

INT WINAPI ReadDeviceBCD32(LPCSTR sNodeName,LPCSTR sDeviceName,DWORD* odwData,WORD wCount);

• 単精度浮動小数点データ

INT WINAPI ReadDeviceFloat(LPCSTR sNodeName,LPCSTR sDeviceName,FLOAT* oflData,WORD wCount);

• 倍精度浮動小数点データ

INT WINAPI ReadDeviceDouble(LPCSTR sNodeName,LPCSTR sDeviceName,DOUBLE* odbData,WORD wCount);

• 文字列データ

INT WINAPI ReadDeviceStr(LPCSTR sNodeName,LPCSTR sDeviceName,LPSTR psData,WORD wCount);

• 汎用データ

INT WINAPI ReadDevice(LPCSTR sNodeName,LPCSTR sDeviceName,LPVOID pData,WORD wCount,WORD wAppKind);

• 汎用データ(Variant型)

INT WINAPI ReadDeviceVariant(LPCSTR sNodeName,LPCSTR sDeviceName,LPVARIANT pData,WORD wCount,WORD wAppKind);

シングルハンドル系ダイレクトライトAPI

• ビットデータ

INT WINAPI WriteDeviceBit(LPCSTR sNodeName,LPCSTR sDeviceName,WORD* pwData,WORD wCount);

• 16ビットデータ

INT WINAPI WriteDevice16(LPCSTR sNodeName,LPCSTR sDeviceName,WORD* pwData,WORD wCount);

• 32ビットデータ

INT WINAPI WriteDevice32(LPCSTR sNodeName,LPCSTR sDeviceName,DWORD* pdwData,WORD wCount);

• 16ビットBCDデータ

INT WINAPI WriteDeviceBCD16(LPCSTR sNodeName,LPCSTR sDeviceName,WORD* pwData,WORD wCount);

• 32ビットBCDデータ

INT WINAPI WriteDeviceBCD32(LPCSTR sNodeName,LPCSTR sDeviceName,DWORD* pdwData,WORD wCount);

• 単精度浮動小数点データ

INT WINAPI WriteDeviceFloat(LPCSTR sNodeName,LPCSTR sDeviceName,FLOAT* pflData,WORD wCount);

• 倍精度浮動小数点データ

INT WINAPI WriteDeviceDouble(LPCSTR sNodeName,LPCSTR sDeviceName,DOUBLE* pdbData,WORD wCount);

• 文字列データ

INT WINAPI WriteDeviceStr(LPCSTR sNodeName,LPCSTR sDeviceName,LPCSTR psData,WORD wCount);

• 汎用データ

INT WINAPI WriteDevice(LPCSTR sNodeName,LPCSTR sDeviceName,LPVOID pData,WORD wCount,WORD wAppKind);

• 汎用データ(Variant型)

INT WINAPI WriteDeviceVariant(LPCSTR sNodeName,LPCSTR sDeviceName,LPVARIANT pData,WORD wCount,WORD wAppKind);

シングルハンドル系グループシンボルリードAPI

• グループシンボル

INT WINAPI ReadSymbol(LPCSTR sNodeName,LPCSTR sSymbolName,LPVOID oReadBufferData);

• グループシンボル(Variant型)

INT WINAPI ReadSymbolVariant(LPCSTR sNodeName,LPCSTR sSymbolName,LPVARIANT pData);

シングルハンドル系グループシンボルライトAPI

• グループシンボル

INT WINAPI WriteSymbol(LPCSTR sNodeName,LPCSTR sSymbolName,LPVOID pWriteBufferData);

• グループシンボル(Variant型)

INT WINAPI WriteSymbolVariant(LPCSTR sNodeName,LPCSTR sSymbolName,LPVARIANT pData);

引数

• sNodeName : 局名は「#WinGP」固定になります。

sDeviceName: GP-Pro EXで登録されたシンボル名、またはデバイスアドレスを直接記述します。

• 例1)シンボルで指定する場合
  "SWITCH1"

• 例2)デバイスアドレスを直接指定する場合
  "M100"

シンボルで指定する場合、各関数で指定できるデータタイプは次のとおりです。

• pxxData : Read/Writeデータへのポインタ

値の読み込み先または書き込み先となるデータへのポインタを指定します。各関数に応じたデータ型のポインタを指定してください。

• wCount : Read/Writeデータ数

Read/WriteDeviceStr関数の場合、文字列データのデータ数は1バイト単位です。シンボルが16ビット幅のデバイスの場合は2文字、32ビット幅のデバイスの場合は4文字単位で指定してください。
読み書きできる最大リード数/ライト数は下表のとおりです。

• wAppKind : データタイプ値

データタイプ値の指定方法は値を直接指定する方法と、定義名で指定する方法があります。詳細は以下を参照してください。
38.9.5.1 データ型

戻り値

正常終了: 0

異常終了 : エラーコード

補足

• Read/WriteDeviceBit関数を使用する場合

pwDataには、wCount数分だけD0ビットから詰めて格納します。
例: wCountが20の場合

• 連続する複数ビットデータを扱う場合

Read/WriteDeviceBitよりRead/WriteDevice16やRead/WriteDevice32で16/32ビット単位のRead/Writeの方が効率的です。
「*」には不定な値が入ります。アプリケーションプログラムでマスクしてください。

• Read/WriteDeviceBCD16/32関数を使用する場合

接続機器内部で、データをBCDとして扱っている場合は、これらの関数を使用します。ただし、この関数と受け渡しするデータ(pxxDataの内容)は、BCDではなくバイナリデータとなります。
(「WinGP SDK」内部でBCD変換を行っています。)負の数は扱えません。

• 文字列データ関数を使用する場合

文字列データを受け取る変数は、受け取れるだけの十分なデータ領域を確保してください。