zx_sampler_start

摘要

開始取樣到提供的 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 已經啟動取樣器。

另請參閱