摘要
設定執行緒，定期對其堆疊取樣，並寫入提供的 IOBuffer。提供的 IOBuffer 必須是先前由 zx_sampler_create 傳回的項目。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_sampler_attach(zx_handle_t iobuffer,
zx_handle_t thread);
說明
設定執行緒，定期對其堆疊取樣，並寫入提供的 IOBuffer。提供的 IOBuffer 必須是先前由 zx_sampler_create 傳回的項目。取樣的頻率和寫入策略取決於呼叫 zx_sampler_create 時使用的 zx_sampler_config_t。
如果在工作階段開始前附加了執行緒，則會在工作階段開始時取樣。或者，如果在工作階段期間附加執行緒，系統就會立即開始取樣。
錯誤
ZX_ERR_NOT_SUPPORTED kernel.enable-debugging-syscalls 在核心指令列中未設為 true，或 Experimental_thread_sampler_enabled 建構參數未設為 true。
ZX_ERR_PERMISION_DENIED
- iobuffer 不是 zx_sampler_create 傳回的 IOBuffer。- 討論串沒有 ZX_RIGHT_READ。