IBRD

ボードレベル/デバイスレベル

---

目的

デバイスからユーザバッファにデータを読み取ります。

形式

C

unsigned long ibrd (int ud, void *rdbuf, size_t count)

Visual Basic

CALL ibrd (ud%, rdbuf$)

または

status% = ilrd (ud%, rdbuf$, count&)

対話式制御（使用に関する注意）

ibrd count

入力

ud	ボードまたはデバイスデスクリプタ
count	GPIBから読み取るバイト数

出力

rdbuf	データが読み取られるバッファのアドレス
関数からの戻り値	Ibstaの値

説明

デバイスレベル

udがデバイスデスクリプタの場合、ibrdはGPIBのアドレスを指定し、countバイトまでのデータ読み取り、rdbufで指定されたバッファにデータを入れます。countバイトのデータを受信するかENDを受信すると、操作は正常終了します。タイムアウト時間内に転送が完了できないと、処理はエラーで終了します。転送された実際のバイト数はIbcntグローバル関数に返されます。

ボードレベル

udがボードデスクリプタの場合、ibrdはcountバイトまでのデータをGPIBデバイスから読み取りrdbufによって指定されたバッファにそのデータを配置します。ボードレベルのibrdは、GPIBがすでに正しくアドレス指定されているものと仮定します。countバイトのデータを受信するかENDを受信すると、操作は正常終了します。転送をタイムアウト時間内に完了できなかったり、あるいはボードがCICでない場合にCICがGPIB上でDCL（Device Clear: デバイスクリア）を送信すると、操作はエラーで終了します。転送された実際のバイト数はIbcntグローバル関数に返されます。

発生する可能性のあるエラー

EABO	タイムアウト時間内にcountバイトまたはENDを受信しなかったか、あるいは読み取り処理の開始後にDCL（Device Clear: デバイスクリア）を受信しました。
EADR	ボードレベル: GPIBが正しくアドレス指定されませんでした。ibcmdを使ってGPIBをアドレス指定してください。
	デバイスレベル: デバイスのGPIBアドレスとアクセスボードのGPIBアドレス間に競合が存在します。代わりにibconfig（IbcPADとIbcSAD）を使用してください。
EARG	バッファまたはcountが無効です。
EBUS	デバイスレベル: デバイスがGPIBに接続されていません。
ECIC	デバイスレベル: アクセスボードがCICでありません。デバイスレベルのコールとバスの管理を参照してください。
EDVR	NI-488.2ドライバの構成またはインストールが正しくありません。
EHDL	udが無効または範囲外です。
ELCK	他の処理によりロックされているため、要求された動作が行われませんでした。
ENEB	インタフェースが取り付けられていないか、正しく構成されていません。
EOIP	非同期I/Oの処理中です。