zx_debug_read

摘要

讀取來自偵錯序列埠的訊息。

宣告

#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 的長度 (以位元組為單位) 會在指向 實際。

這個函式會等到至少一個位元組可用後才會傳回。 最多會傳回 buffer_size 個位元組。

NOTE: 偵錯資料只有一個緩衝區 序列及呼叫 zx_debug_read 則會使用這些資料。如果有多項程式呼叫 這樣就能一次收到資料串流的片段

如要使用 zx_debug_read() 函式，您必須指定 kernel.enable-serial-syscalls=true 執行。否則 這個函式會傳回 ZX_ERR_NOT_SUPPORTED。

權限

handle 須有包含底數的 ZX_RSRC_KIND_SYSTEM 資源類型 ZX_RSRC_SYSTEM_DEBUG_BASE。

傳回值

成功時會傳回 ZX_OK。buffer 指向的位置包含 已讀取的 actual 個位元組。

錯誤

ZX_ERR_NOT_SUPPORTED kernel.enable-serial-syscalls未設為 true 執行指令碼

ZX_ERR_INVALID_ARGS buffer 或 actual 為 NULL。

另請參閱