摘要
建立新的公車交易發起者。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_bti_create(zx_handle_t iommu,
uint32_t options,
uint64_t bti_id,
zx_handle_t* out);
說明
zx_bti_create() 會建立新的公車交易發起者
擁有 IOMMU 的控制代碼和裝置的硬體交易 ID
找到一樣的二氧化碳當量
options 必須為 0 (保留供日後建立旗標的定義使用)。
成功處理後，系統會傳回新 BTI 的控制代碼。這個帳號代碼將具備相關權限
ZX_RIGHT_READ、ZX_RIGHT_WRITE、ZX_RIGHT_MAP、ZX_RIGHT_INSPECT、
ZX_RIGHT_DUPLICATE，以及 ZX_RIGHT_TRANSFER。
權限
iommu 必須是 ZX_OBJ_TYPE_IOMMU 類型，且包含 ZX_RIGHT_NONE。
傳回值
zx_bti_create() 會傳回 ZX_OK 和新 BTI 的控制代碼
(透過) 成功的故事。失敗時，錯誤的值為負值
。
錯誤
ZX_ERR_BAD_HANDLE iommu 不是有效的帳號代碼。
ZX_ERR_WRONG_TYPE iommu 不是 iommu 控點。
ZX_ERR_ACCESS_DENIED iommu 帳號代碼的權限不足。
ZX_ERR_INVALID_ARGS bti_id 對指定的 IOMMU 無效，
out 是無效的指標，或 options 為非零。
ZX_ERR_NO_MEMORY 因記憶體不足而失敗。
使用者空間無法妥善處理這種 (異常) 錯誤。
在日後的版本中不會再發生這個錯誤。