HALCON Website / HALCON Operator-Referenz / System / Multithreading
KlassenKlassenKlassenKlassen | | | | Operatoren

create_eventcreate_eventCreateEventcreate_eventCreateEventCreateEvent (Operator)

Name

create_eventcreate_eventCreateEventcreate_eventCreateEventCreateEvent — Erzeugen eines Event-Synchronisationsobjektes.

Signatur

create_event( : : AttribName, AttribValue : EventHandle)

Herror create_event(const char* AttribName, const char* AttribValue, Hlong* EventHandle)

Herror T_create_event(const Htuple AttribName, const Htuple AttribValue, Htuple* EventHandle)

Herror create_event(const HTuple& AttribName, const HTuple& AttribValue, Hlong* EventHandle)

void HEvent::CreateEvent(const HTuple& AttribName, const HTuple& AttribValue)

void CreateEvent(const HTuple& AttribName, const HTuple& AttribValue, HTuple* EventHandle)

void HEvent::HEvent(const HTuple& AttribName, const HTuple& AttribValue)

void HEvent::HEvent(const HString& AttribName, const HString& AttribValue)

void HEvent::HEvent(const char* AttribName, const char* AttribValue)

void HEvent::CreateEvent(const HTuple& AttribName, const HTuple& AttribValue)

void HEvent::CreateEvent(const HString& AttribName, const HString& AttribValue)

void HEvent::CreateEvent(const char* AttribName, const char* AttribValue)

void HOperatorSetX.CreateEvent(
[in] VARIANT AttribName, [in] VARIANT AttribValue, [out] VARIANT* EventHandle)

void HEventX.CreateEvent(
[in] VARIANT AttribName, [in] VARIANT AttribValue)

static void HOperatorSet.CreateEvent(HTuple attribName, HTuple attribValue, out HTuple eventHandle)

public HEvent(HTuple attribName, HTuple attribValue)

public HEvent(string attribName, string attribValue)

void HEvent.CreateEvent(HTuple attribName, HTuple attribValue)

void HEvent.CreateEvent(string attribName, string attribValue)

Beschreibung

Ein Event ist ein Mutex, der keinem Thread gehört. D.h., er kann von einem anderen Thread freigegeben werden als von dem, der ihn gesperrt hat. Daher werden Events meist dann eingesetzt, wenn ein Thread einem anderem, wartenden Thread signalisieren soll, dass dieser weiterlaufen kann. Dieses Verständnis von Events leitet sich aus der Definition eines Events der WIN32-API oder der einer Semaphore (mit Zähler 0) der POSIX-Thread-Spezifikation ab.

create_eventcreate_eventCreateEventcreate_eventCreateEventCreateEvent legt ein Eventobjekt an und initialisiert es entsprechend der Attribute, die über die Parameter AttribNameAttribNameAttribNameAttribNameAttribNameattribName und AttribValueAttribValueAttribValueAttribValueAttribValueattribValue gesetzt werden. AttribNameAttribNameAttribNameAttribNameAttribNameattribName definiert die Klasse und AttribValueAttribValueAttribValueAttribValueAttribValueattribValue den Typ des Events. Im Folgenden werden die möglichen Attributwerte für die gelisteten Attributnamen beschrieben:

''""""""""""

der leere String setzt die Standardattribute.

'type'"type""type""type""type""type"

spezifiziert das Verhalten eines Events, wenn ein Thread auf ein Signal warten muss:

'sleep'"sleep""sleep""sleep""sleep""sleep"

unterbricht den aufrufenden Thread und legt ihn schlafen (Standard).

'spin'"spin""spin""spin""spin""spin"

ist die schnelle Implementierung eines Events, die in einer Schleife auf die Signalisierung des Events wartet. Dieser Typ ist nicht rekursiv.

Nach der Initialisierung ist ein Event gesperrt.

Parallelisierung

Parameter

AttribNameAttribNameAttribNameAttribNameAttribNameattribName (input_control)  number(-array) → HTupleHTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)

Event-Attribut.

Defaultwert: []

Werteliste: 'type'"type""type""type""type""type"

AttribValueAttribValueAttribValueAttribValueAttribValueattribValue (input_control)  number(-array) → HTupleHTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)

Event-Attributwert.

Parameteranzahl: AttribValue == AttribName

Defaultwert: []

Werteliste: 'sleep'"sleep""sleep""sleep""sleep""sleep", 'spin'"spin""spin""spin""spin""spin"

EventHandleEventHandleEventHandleEventHandleEventHandleeventHandle (output_control)  event → HEvent, HTupleHTupleHEvent, HTupleHEventX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Event-Synchronisationsobjekt.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert create_eventcreate_eventCreateEventcreate_eventCreateEventCreateEvent den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

wait_eventwait_eventWaitEventwait_eventWaitEventWaitEvent, signal_eventsignal_eventSignalEventsignal_eventSignalEventSignalEvent, clear_eventclear_eventClearEventclear_eventClearEventClearEvent

Siehe auch

clear_eventclear_eventClearEventclear_eventClearEventClearEvent

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH