timed_wait_conditiontimed_wait_conditionTimedWaitConditiontimed_wait_conditionTimedWaitConditionTimedWaitCondition (Operator)

Name

timed_wait_conditiontimed_wait_conditionTimedWaitConditiontimed_wait_conditionTimedWaitConditionTimedWaitCondition — Begrenztes Warten auf das Signal eines Condition-Synchronisationsobjektes.

Signatur

timed_wait_condition( : : ConditionHandle, MutexHandle, Timeout : )

Beschreibung

timed_wait_conditiontimed_wait_conditionTimedWaitConditiontimed_wait_conditionTimedWaitConditionTimedWaitCondition gibt MutexHandleMutexHandleMutexHandleMutexHandleMutexHandlemutexHandle frei und wartet auf das Signalisieren von ConditionHandleConditionHandleConditionHandleConditionHandleConditionHandleconditionHandle. Wie bei wait_conditionwait_conditionWaitConditionwait_conditionWaitConditionWaitCondition geschehen Freigabe und Warten atomar, jedoch kann die Dauer des Wartens begrenzt werden. Falls ConditionHandleConditionHandleConditionHandleConditionHandleConditionHandleconditionHandle nicht während der von TimeoutTimeoutTimeoutTimeoutTimeouttimeout vorgegebenen Zeit (in Mikrosekunden) signalisiert wurde, wird der Mutex MutexHandleMutexHandleMutexHandleMutexHandleMutexHandlemutexHandle wieder gesperrt und timed_wait_conditiontimed_wait_conditionTimedWaitConditiontimed_wait_conditionTimedWaitConditionTimedWaitCondition wirft den Fehler H_ERR_TIMEOUT.

Negative Werte für TimeoutTimeoutTimeoutTimeoutTimeouttimeout bedeuten ein unendlich langes Warten.

Parallelisierung

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

Parameter

ConditionHandleConditionHandleConditionHandleConditionHandleConditionHandleconditionHandle (input_control) condition → (integer)

Condition-Synchronisationsobjekt.

MutexHandleMutexHandleMutexHandleMutexHandleMutexHandlemutexHandle (input_control) mutex → (integer)

Mutex-Synchronisationsobjekt.

TimeoutTimeoutTimeoutTimeoutTimeouttimeout (input_control) number → (integer)

Timeout in Mikrosekunden.

Sind die Parameterwerte korrekt, dann liefert timed_wait_conditiontimed_wait_conditionTimedWaitConditiontimed_wait_conditionTimedWaitConditionTimedWaitCondition den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt. Kommt es zu einer Zeitüberschreitung, wird der Wert H_ERR_TIMEOUT zurück gegeben.

Nachfolger

signal_conditionsignal_conditionSignalConditionsignal_conditionSignalConditionSignalCondition, clear_conditionclear_conditionClearConditionclear_conditionClearConditionClearCondition

Modul

Foundation

Operatoren