FC_SemaphoreMeGiveForce

FC_SemaphoreMeGiveForce - Allgemeine Informationen

Übersicht

Typ	Funktion
Verfügbar ab:	V1.0.7.0
Versionen:	Aktuelle Version

Aufgabe

Freigabe einer Semphore ungeachtet der zugehörigen Task.

Beschreibung

HINWEIS: Die Funktion ist nur eine Hilfe beim Debugging. Sie darf sonst zu keinem anderen Zweck eingesetzt werden! Eine Missachtung kann zur Zerstörung des Inhalts von Datenstrukturen in kritischen Bereichen führen!

Für Einschränkungen bei der Verwendung siehe die Hinweise zur Verwendung der Funktion „SemaphoreMutualExclusion" Function.

Schnittstelle

Ausgang	Datentyp	Beschreibung
q_etDiag	GD.ET_Diag	Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. Ein Wert ungleich ET_Diag.Ok entspricht einer Diagnosemeldung.
q_etDiagExt	ET_DiagExt	POU-spezifischer, diagnosebezogener Ausgang. q_etDiag = ET_Diag.Ok -> Statusmeldung q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose.

Ein Wert ungleich ET_Diag.Ok entspricht einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer, diagnosebezogener Ausgang.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

Ein-/Ausgang	Datentyp	Beschreibung
iq_stSemMe	ST_SemaphoreMe	Struktur der freizugebenden Semaphore

Rückgabewert

Datentyp	Beschreibung
BOOL	TRUE: Die Semaphore wurde erfolgreich freigegeben. FALSE: Die Semaphore wurde nicht freigegeben.

Diagnosemeldungen

q_etDiag	q_etDiagExt	Enumerationswert	Beschreibung
OK	Ok	0	OK
InputParameterInvalid	SemaphoreMeNotInitialized	266	SemaphoreMe ist nicht initialisiert.
UnexpectedProgramBehavior	SemaphoreMeGiveForceFailed	268	GiveForce der SemaphoreMe ist fehlgeschlagen.

Enumerationsname:	Ok
Enumerationswert:	0
Beschreibung:	OK

Die Semaphore wurde erfolgreich freigegeben.

SemaphoreMeGiveForceFailed

Enumerationsname:	SemaphoreMeGiveForceFailed
Enumerationswert:	268
Beschreibung:	GiveForce der SemaphoreMe ist fehlgeschlagen.

Problem	Ursache	Lösung
-	Es ist ein Fehler in der internen Abarbeitung aufgetreten.	Bitte informieren Sie das Supportteam über diesen Fehler.

SemaphoreMeNotInitialized

Enumerationsname:	SemaphoreMeNotInitialized
Enumerationswert:	266
Beschreibung:	SemaphoreMe ist nicht initialisiert.

Problem	Ursache	Lösung
-	Die Semaphore ist nicht initialisiert.	Übergeben Sie am Eingang FC_SemaphoreMeCreate dieselbe Semaphore, die beim Aufruf von iq_stSemMe verwendet wurde.