IBRDA

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

---

目的

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

形式

C

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

Visual Basic

CALL ibrda (ud%, rdbuf$)

または

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

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

ibrda count

入力

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

出力

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

説明

デバイスレベル

udがデバイスデスクリプタの場合、ibrdaはGPIBのアドレスを指定し、countバイトまでのデータをGPIBデバイスから非同期に読み取り、rdbufで指定されたバッファにデータを入れます。countバイトのデータを受信するかENDを受信すると、操作は正常終了します。転送された実際のバイト数はIbcntグローバル関数に返されます。

ボードレベル

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

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

非同期のI/Oコール（ibcmda、ibrda、ibwrta）は、I/O処理中にアプリケーションがGPIB以外の処理を実行できるように設計されています。非同期のI/Oが開始されると、後続のNI-488.2コールは厳しく制限されます。実行中のI/O処理を干渉するようなコールはすべて拒否されます。 この場合、ドライバがEOIPを返します。

I/Oが完了したら、アプリケーションはNI-488.2ドライバと再同期化する必要があります。再同期化を行うには、以下のいずれかのコールを使用してください。

ibwait	返されたIbstaにCMPLが含まれている場合、ドライバとアプリケーションは再同期化されています。
ibnotify	ibnotify Callbackに渡されたIbstaの値にCMPLが含まれている場合、ドライバとアプリケーションは再同期化されています。
ibstop	I/Oが取り消され、ドライバとアプリケーションが再同期化されます。
ibonl	I/Oが取り消されインタフェースはリセットされて、ドライバとアプリケーションが再同期化されます。

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

EABO	ボードレベル: CICから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の処理中です。