摘要
建立允許存取核心偵錯記錄檔的物件。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_debuglog_create(zx_handle_t resource,
uint32_t options,
zx_handle_t* out);
說明
zx_debuglog_create() 會建立物件，允許透過 zx_debuglog_read() 和 zx_debuglog_write() 系統呼叫存取核心偵錯記錄。
如果 options 設為 0，傳回的控制代碼將擁有 ZX_RIGHT_WRITE 權限，並授予核心偵錯記錄檔的唯寫存取權。如果 options 設為 ZX_LOG_FLAG_READABLE，傳回的控制代碼會另外包含 ZX_RIGHT_READ，授予核心偵錯記錄檔的讀取/寫入權限。
權限
資源必須具備資源種類 ZX_RSRC_KIND_SYSTEM 和基礎 ZX_RSRC_SYSTEM_DEBUGLOG_BASE。
傳回值
zx_debuglog_create() 在成功時傳回 ZX_OK，並將控制代碼傳回「out」中建立的物件。
如果失敗，系統會傳回負值的錯誤值。
錯誤
ZX_ERR_INVALID_ARGS 選項包含核心無法理解的值
ZX_ERR_WRONG_TYPE 資源不是 ZX_RSRC_KIND_SYSTEM 種類且基礎 ZX_RSRC_SYSTEM_DEBUGLOG_BASE。
ZX_ERR_NO_MEMORY 因記憶體不足而失敗。