zx_sampler_start

摘要

開始取樣至提供的 IOBuffer。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_sampler_start(zx_handle_t iobuffer);

說明

開始對每個附加的執行緒進行取樣，並將每個樣本寫入提供的 IOBuffer。提供的 IOBuffer 必須是先前由 zx_sampler_create 傳回的 IOBuffer。

如果嘗試啟動已啟動的會話，系統會傳回錯誤，但不會停止或修改會話。

重新啟動先前開始/停止的工作階段時，系統會繼續寫入先前工作階段停止時的緩衝區。

錯誤

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 取樣器已啟動。

另請參閱