FC_GetAllModulesOfType

FC_GetAllModulesOfType – Allgemeine Informationen

Übersicht

Typ	Funktion
Verfügbar ab	V1.0.4.0

Aufgabe

Alle Module eines bestimmten Typs innerhalb eines Baums ermitteln

Beschreibung

Der Modulbaum am Eingang i_pstMachineStandardItf wird in allen Unterebenen nach Modulen vom Typ i_dwWantedType durchsucht. Die Verweise auf die Schnittstellen dieser Module werden in das Array am Eingang i_pdwResultSet geschrieben.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_pstMachineStandardItf	POINTER TO ST_StandardModuleInterface	Zeiger auf die Standardschnittstellen der MainMachine. Verbindet diesen Eingang immer mit "ADR(SR_MainMachine.stMachineInterface)".
i_dwWantedType	DWORD	Typ des Moduls, nach dem gesucht werden soll.
i_pdwResultSet	POINTER TO DWORD	Adresse eines Arrays, in dem die Adressen der Standardmodulschnittstellen eingegeben werden sollen.
i_udiResultSetSize	UDINT	Anzahl der möglichen Elemente des Arrays am Eingang i_pdwResultSet.

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

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose.

Ein Wert ungleich ET_Diag.Ok entspricht einer Fehlermeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer Ausgang des Diagnosegeräts.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Fehlermeldung

Rückgabewert

Datentyp	Beschreibung
UDINT	>0 Anzahl der gefundenen Module dieses Typs

Diagnosemeldungen

q_etDiag	q_etDiagExt	Aufzählungswert	Beschreibung
OK	Ok	0	OK
ExecutionAborted	MissingExtInit	56	Die Initialisierung der Ext-Struktur fehlt.
InputParameterInvalid	PointerMachineStandardItfInvalid	58	Der Zeiger MachineStandardItf ist ungültig.
InputParameterInvalid	PointerResultSetInvalid	68	Das Zeiger auf ResultSet ist ungültig.
InputParameterInvalid	ResultSetSizeRange	69	ResultSetSize ist außerhalb des gültigen Bereichs.

MissingExtInit

Aufzählungsname:	MissingExtInit
Aufzählungswert:	56
Beschreibung:	Die Initialisierung der Ext-Struktur fehlt.

Problem	Ursache	Lösung
-	Initialisierung von Ext fehlgeschlagen	Initialisierung erneut starten

Aufzählungsname:	Ok
Aufzählungswert:	0
Beschreibung:	OK

Die Funktion GetAllModulesOfType wurde ohne Ausnahmen ausgeführt

PointerMachineStandardItfInvalid

Aufzählungsname:	PointerMachineStandardItfInvalid
Aufzählungswert:	58
Beschreibung:	Der Zeiger MachineStandardItf ist ungültig.

Problem	Ursache	Lösung
-	Der Zeiger MachineStandardItf ist ungültig	Der Eingang i_pstMachineStandardItf muss mit einem Zeiger auf die Struktur ST_StandardModuleInterface der MainMachine verbunden sein.

PointerResultSetInvalid

Aufzählungsname:	PointerResultSetInvalid
Aufzählungswert:	68
Beschreibung:	Das Zeiger auf ResultSet ist ungültig.

Problem	Ursache	Lösung
-	Der Zeiger ResultSet ist ungültig.	Der Wert ResultSet muss <> 0 sein.

ResultSetSizeRange

Aufzählungsname:	ResultSetSizeRange
Aufzählungswert:	69
Beschreibung:	ResultSetSize ist außerhalb des gültigen Bereichs.

Problem	Ursache	Lösung
-	ResultSetSize ist ungültig.	Der Wert ResultSetSize muss >=1 sein.