摘要
将消息写入内核调试日志。
声明
#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 不严格要求采用任何特定格式，但大多数用户空间工具会假定内容是没有任何 NUL 终止的有效 UTF-8 字符串。buffer 会被截断至小于 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 句柄不是调试日志句柄。