Inhaltsverzeichnis
Werbung
Beschreibung der einzelnen DP-Funktionen und Daten sowie Fehlercodes
4.1
Liste der Funktionen CP 5613 und CP 5614
Darstellungskonventionen
In den folgenden Funktionsbeschreibungen gibt es in der Funktionsdeklaration ge-
nerelle Darstellungen, die hier beschrieben werden:
Darstellung
// in
// out
// inout
Einheitliches Aufrufschema der Funktionen der dp_base.dll
Die Funktionen sind nach einem einheitlichen Schema aufgebaut:
Fehlerklasse = DP_... (
Jede Funktion gibt als Rückgabewert eine der im folgenden beschriebenen Fehler-
klassen zurück. Im Fehlerfall enthält die Struktur DP_ERROR_T – in Abhängigkeit
der Fehlerklasse – detaillierte Fehlerinformationen (siehe Kapitel 4.4). Die Fehler-
auswertung und die Funktion DP_get_err_txt werden auch in den mitgelieferten
Beispielprogrammen erläutert.
In den Funktionsbeschreibungen werden die Return-Werte wie folgt tabellarisch
beschrieben, erläutert anhand des Funktionsaufrufs DP_reset_cp:
• Falls der Return-Wert DP_OK ist, so bedeutet dies, dass die Funktion erfolg-
reich ausgeführt wurde. In diesem Beispiel ist der CP also tatsächlich zurück-
gesetzt worden.
• Falls der Return-Wert DP_ERROR_CI ist und die Komponente error_code in
der Fehlerstruktur DP_ERROR_T den Wert CI_RET_RESET_CP_USED hat,
so bedeutet dies, dass der CP nicht zurückgesetzt worden ist, weil noch andere
Anwendungen den CP benutzen. Auf solche ausdrücklich angegebenen Feh-
lercodes sollte Ihr Anwenderprogramm vorbereitet sein.
• In allen anderen Fällen liegt ein Fehler vor, der nur in Ausnahmefällen auftritt.
Eine Liste der Fehlercodes finden Sie in Kapitel 4.4.2 „Fehlercodes".
68
Der Wert wird vom Anwenderprogramm als Input der Funk-
tion zur Verfügung gestellt.
Der Wert wird von der Funktion an das Anwenderprogramm
zurückgegeben.
Der Wert muss vorbesetzt werden und ist nach Abschluss
der Funktion aktualisiert.
Vorgabeparameter 1,
...
Vorgabeparameter n,
DP_ERROR_T *error);
Programmierschnittstelle DP-Base für CP 5613/CP 5614
Bedeutung
C79000-G8900-C139-04
Werbung
Inhaltsverzeichnis
