try_wait_eventT_try_wait_eventTryWaitEventTryWaitEvent (Operator)

Name

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

Signatur

try_wait_event( : : EventHandle : Busy)

Beschreibung

try_wait_eventtry_wait_eventTryWaitEventTryWaitEventTryWaitEvent verhält sich identisch zu wait_eventwait_eventWaitEventWaitEventWaitEvent, 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

EventHandleEventHandleEventHandleEventHandleeventHandle (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_eventTryWaitEventTryWaitEventTryWaitEvent den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_eventcreate_eventCreateEventCreateEventCreateEvent

Nachfolger

signal_eventsignal_eventSignalEventSignalEventSignalEvent

Siehe auch

wait_eventwait_eventWaitEventWaitEventWaitEvent

Modul

Foundation

Operatoren