try_wait_eventT_try_wait_eventTryWaitEventTryWaitEventtry_wait_event (算子)

名称

try_wait_eventT_try_wait_eventTryWaitEventTryWaitEventtry_wait_event — 仅当事件同步对象未锁定时，才将其锁定。

签名

try_wait_event( : : EventHandle : Busy)

描述

try_wait_eventtry_wait_eventTryWaitEventTryWaitEventTryWaitEventtry_wait_event behaves identically to wait_eventwait_eventWaitEventWaitEventWaitEventwait_event, except that it does not block the calling thread when waiting until the object is signaled but returns immediately. The state of the event before entering try_wait_eventtry_wait_eventTryWaitEventTryWaitEventTryWaitEventtry_wait_event is returned in BusyBusyBusyBusybusybusy. 1 indicates that the event was non-signaled before calling try_wait_eventtry_wait_eventTryWaitEventTryWaitEventTryWaitEventtry_wait_event, 0 that the event was signaled.

执行信息

多线程类型：独立（即使使用独占算子也能并行运行）。
多线程作用域：全局（可从任何线程调用）。
未采用并行化处理。

参数

EventHandleEventHandleEventHandleEventHandleeventHandleevent_handle (输入控制) event → (handle)

Event synchronization object.

BusyBusyBusyBusybusybusy (输出控制) number → (integer)

Object already locked?

结果

If the event handle is valid, the operator try_wait_eventtry_wait_eventTryWaitEventTryWaitEventTryWaitEventtry_wait_event 返回 2 ( H_MSG_TRUE )。如有必要，则抛出异常。

可能的前趋

create_eventcreate_eventCreateEventCreateEventCreateEventcreate_event

可能的后继

signal_eventsignal_eventSignalEventSignalEventSignalEventsignal_event

另见

wait_eventwait_eventWaitEventWaitEventWaitEventwait_event

模块

基础

算子