try_wait_eventT_try_wait_eventTryWaitEventTryWaitEventtry_wait_event (Operator)

Name

try_wait_eventT_try_wait_eventTryWaitEventTryWaitEventtry_wait_event — Sperren eines Event-Synchronisationsobjektes wenn es frei ist.

Signatur

try_wait_event( : : EventHandle : Busy)

Beschreibung

try_wait_eventtry_wait_eventTryWaitEventTryWaitEventtry_wait_event verhält sich identisch zu wait_eventwait_eventWaitEventWaitEventwait_event, bis auf dass der aufrufende Thread nicht blockiert, wenn er warten muss, bis das Eventobjekt signalisiert wird. Der Aufruf kommt in jedem Fall sofort zurück und enthält im Parameter BusyBusyBusybusybusy den Zustand des Events vor dem Versuch ihn zu sperren. 1 bedeutet, dass das Event bereits gesperrt ist, 0, dass das Event signalisiert war und nun durch den aufrufenden Thread gesperrt wurde.

Ausführungsinformationen

Multithreading-Typ: independent (läuft parallel auch zu exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

EventHandleEventHandleEventHandleeventHandleevent_handle (input_control) event → (handle)

Event-Synchronisationsobjekt.

BusyBusyBusybusybusy (output_control) number → (integer)

Objekt bereits gesperrt?

Ergebnis

Ist der Parameterwert korrekt, dann liefert try_wait_eventtry_wait_eventTryWaitEventTryWaitEventtry_wait_event den Wert 2 ( H_MSG_TRUE) . Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_eventcreate_eventCreateEventCreateEventcreate_event

Nachfolger

signal_eventsignal_eventSignalEventSignalEventsignal_event

Siehe auch

wait_eventwait_eventWaitEventWaitEventwait_event

Modul

Foundation

Operatoren