摘要
將訊息寫入核心偵錯記錄檔。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_debuglog_write(zx_handle_t handle,
uint32_t options,
const void* buffer,
size_t buffer_size);
說明
zx_debuglog_write() 會嘗試將大小 buffer_size 位元組的緩衝區寫入核心偵錯記錄檔。記錄項目的寫入嚴重性為 ZX_LOG_INFO。
「buffer」並不嚴格要求任何特定格式，但大多數使用者空間工具會假設內容是有效的 UTF-8 字串，且沒有任何 NUL 終止。緩衝區會截斷為小於 ZX_LOG_RECORD_MAX 的某些大小，以便符合 zx_log_record_t 的 data 欄位。
options 必須設為 0。
權限
handle 必須是 ZX_OBJ_TYPE_LOG 類型，且包含 ZX_RIGHT_WRITE。
傳回值
zx_debuglog_read() 在成功時傳回 ZX_OK。失敗時會傳回負值的錯誤值。
錯誤
ZX_ERR_ACCESS_DENIED 帳號代碼沒有 ZX_RIGHT_WRITE。
「ZX_ERR_BAD_HANDLE」的帳號代碼並非有效的帳號代碼。
ZX_ERR_INVALID_ARGS 給「options」的值無效，或「buffer」為無效指標。
ZX_ERR_WRONG_TYPE 帳號代碼不是偵錯記錄檔控制代碼。