この API は、ドライバーの実行をトランザクション モードで開始します。
その結果生じるすべての I/O 動作は、内部で管理されるバッファーに格納されます。ドライバーが I/O 動作を実行してデバイスをコンフィギュレーションするには、ユーザーがトランザクションを明示的に発行する必要があります。この API によって割り当てられるトランザクション インスタンスは、実行中のコンテキストのスレッド ID に関連付けられます。SubmitTransaction API は、TxnInst パラメーターに NULL を指定して同じコンテキストから呼び出す必要があります。
注記: ENABLE_AUTO_FLUSH フラグがセットされている場合、API の結果として Read/MaskPoll/BlockWrite/BlockSet/CmdWrite/RunOp 動作が発生すると、ドライバーはトランザクション バッファーを自動的にフラッシュします。DISABLE_AUTO_FLUSH フラグがセットされている場合、API の結果として Read/MaskPoll/CmdWrite/RunOp 動作が発生すると、ドライバーはエラーを返します。いずれの場合も、ユーザーは XAie_SubmitTransaction API を呼び出して、コマンド バッファーに格納されている保留中の I/O 動作をすべてフラッシュする必要があります。
プロトタイプ
AieRC XAie_StartTransaction(XAie_DevInst *DevInst, u32 Flags);パラメーター
次の表に、XAie_StartTransaction 関数の引数を示します。
| タイプ | メンバー | 説明 |
|---|---|---|
| XAie_DevInst * | DevInst | デバイス インスタンス ポインター。 |
| u32 | Flags | ユーザーによって渡されるフラグ。XAIE_TRANSACTION_ENABLE/DISBALE_AUTO_FLUSH |
戻り値
正常に完了した場合はXAIE_OK、エラーが発生した場合はエラー コード。