总结
从调试串行端口读取消息。
声明
#include <zircon/syscalls.h>
zx_status_t zx_debug_read(zx_handle_t handle,
char* buffer,
size_t buffer_size,
size_t* actual);
说明
zx_debug_read() 尝试从调试串行端口读取数据。参数 buffer_size 用于指定读取缓冲区的字节大小。
buffer 的长度（以字节为单位）存储在 actual 所指向的位置。
此函数会等待至少有一个字节可用，然后才会返回。最多可返回 buffer_size 字节。
NOTE: 只有一个来自调试串行的数据缓冲区，调用 zx_debug_read 会使用这些数据。如果多个程序同时调用此程序，它们将各自收到数据流片段。
如需使用 zx_debug_read() 函数，您必须在内核命令行中指定 kernel.enable-serial-syscalls=true。否则，该函数会返回 ZX_ERR_NOT_SUPPORTED。
权限
handle 必须具有采用基本 ZX_RSRC_SYSTEM_DEBUG_BASE 的资源种类 ZX_RSRC_KIND_SYSTEM。
返回值
成功时返回 ZX_OK。buffer 指向的位置包含读取的实际字节。
错误
内核命令行中的 ZX_ERR_NOT_SUPPORTED kernel.enable-serial-syscalls 未设置为 true。
ZX_ERR_INVALID_ARGS buffer 或 actual 为 NULL。