XAie_MemAttach - XAie_MemAttach - 2024.2 日本語 - UG1642

AI エンジン システム ソフトウェア ドライバー リファレンス マニュアル (UG1642)

Document ID
UG1642
Release Date
2024-11-13
Version
2024.2 日本語

ユーザーが割り当てたメモリを AI エンジン パーティション デバイス インスタンスに接続するメモリ関数です。

プロトタイプ

AieRC XAie_MemAttach(XAie_DevInst *DevInst, XAie_MemInst *MemInst, u64 DevAddr, u64 VAddr, u64 Size, XAie_MemCacheProp Cache, u64 MemHandle);

パラメーター

次の表に、XAie_MemAttach 関数の引数を示します。

表 1. XAie_MemAttach の引数
タイプ メンバー 説明
XAie_DevInst * DevInst デバイス インスタンス
XAie_MemInst * MemInst この関数によって接続される AI エンジン メモリ インスタンスの情報で充填されるメモリ インスタンスへのポインター。
u64 DevAddr 割り当てられたメモリのデバイス アドレス。通常はメモリの物理アドレスです。Linux dmabuf メモリの場合、dmabuf の始点へのオフセットです。
u64 VAddr 割り当てられたメモリの仮想アドレス。Linux dmabuf メモリの場合は必須でないため、NULL でかまいません。Cache: バッファーがキャッシュ可能かどうかを示します。MemHandle: 割り当てられたメモリのハンドル。Linux バックエンド以外のバックエンドでは無視されます。Linux バックエンドの場合、dmabuf のファイル ディスクリプターです。

戻り値

正常に完了した場合は XAIE_OK、エラーが発生した場合はエラー コード。