zx_counter_write

摘要

將值寫入計數器。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_counter_write(zx_handle_t handle, int64_t value);

說明

zx_counter_write() 會將「value」寫入「handle」參照的計數器，並視需要斷言/取消斷言信號。如要瞭解信號的斷言/取消斷言條件，請參閱 zx_counter_add()。

由於計數器上的並行作業可能會交錯，因此實作「計數訊號」同步化通訊協定時，應使用 zx_counter_add()，而非 zx_counter_read()、修改、zx_counter_write() 的序列。

權限

handle 必須包含 ZX_RIGHT_WRITE。

傳回值

zx_counter_write() 會在成功時傳回 ZX_OK。

失敗時，系統會傳回錯誤值。

錯誤

ZX_ERR_WRONG_TYPE 如果 handle 不是計數器 handle。

如果 handle 沒有 ZX_RIGHT_WRITE，則為 ZX_ERR_ACCESS_DENIED。

ZX_ERR_INVALID_ARGS (如果 value 是無效的指標)。

另請參閱