zx_port_queue

摘要

將封包傳送至通訊埠。

宣告

#include <zircon/syscalls.h>
#include <zircon/syscalls/port.h>

zx_status_t zx_port_queue(zx_handle_t handle, const zx_port_packet_t* packet);

說明

zx_port_queue() 會將使用者「封包」排入佇列指定的通訊埠。

zx_port_wait() 會排除使用者封包。如未及時清空封包，可能會導致使用過多核心記憶體，進而產生例外狀況。詳情請參閱 ipc 限制。

typedef struct zx_port_packet {
    uint64_t key;
    uint32_t type;
    zx_status_t status;
    union {
        zx_packet_user_t user;
        zx_packet_signal_t signal;
    };
} zx_port_packet_t;

在 packet 類型中應為 ZX_PKT_TYPE_USER，且只有 user 聯集元素會視為有效：

typedef union zx_packet_user {
    uint64_t u64[4];
    uint32_t u32[8];
    uint16_t u16[16];
    uint8_t   c8[32];
} zx_packet_user_t;

權限

handle 必須是 ZX_OBJ_TYPE_PORT 類型，且具有 ZX_RIGHT_WRITE。

傳回值

zx_port_queue() 會在封包的成功佇列上傳回 ZX_OK。

錯誤

「ZX_ERR_BAD_HANDLE」的帳號代碼無效

ZX_ERR_INVALID_ARGS 封包是無效指標。

ZX_ERR_WRONG_TYPE 處理常式不是通訊埠控制代碼。

ZX_ERR_ACCESS_DENIED 處理常式沒有 ZX_RIGHT_WRITE。

另請參閱