摘要
將訊息寫入核心偵錯記錄。
宣告
#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 位元的 buffer 寫入核心偵錯記錄檔。記錄項目的嚴重性為 ZX_LOG_INFO。
buffer 不需要任何特定格式，但大部分使用者空間
工具會假設內容是有效的 UTF-8 字串，不含任何
空終止。buffer 可能會截斷為小於或剛好的一部分
ZX_LOG_RECORD_MAX 後即可插入 zx_log_record_t 的 data 欄位。
options 必須設為 0。
權限
handle 必須是 ZX_OBJ_TYPE_LOG 類型，且具有 ZX_RIGHT_WRITE。
傳回值
zx_debuglog_write() 會在成功時傳回 ZX_OK。如果失敗，系統會傳回負數錯誤值。
錯誤
ZX_ERR_ACCESS_DENIED handle 沒有 ZX_RIGHT_WRITE。
ZX_ERR_BAD_HANDLE handle 不是有效的 handle。
ZX_ERR_INVALID_ARGS 您提供的 options 值無效，或是 buffer 是無效的指標。
ZX_ERR_WRONG_TYPE handle 不是 debuglog handle。