摘要
開始取樣到提供的 IOBuffer。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_sampler_start(zx_handle_t iobuffer);
說明
開始對每個附加的執行緒進行取樣,並將每個範例寫入提供的 IOBuffer。提供的 IOBuffer 必須是先前由 zx_sampler_create 傳回的項目。
如果嘗試啟動已經啟動的工作階段,系統會傳回錯誤,但不會停止或修改工作階段。
如果重新啟動先前啟動/已停止的工作階段,系統會繼續寫入上一個工作階段中斷處的緩衝區。
錯誤
ZX_ERR_NOT_SUPPORTED
kernel.enable-debugging-syscalls
在核心指令列中未設為 true
,或 Experimental_thread_sampler_enabled 建構參數未設為 true。
ZX_ERR_PERMISION_DENIED
iobuffer 不是 zx_sampler_create 傳回的 IOBuffer。
ZX_ERR_BAD_STATE
已經啟動取樣器。