TCatIoGetOutputPtr
Die Funktion TCatIoGetOutputPtr ordnet dem ausgehenden Prozessabbild ein Ausgabepuffer (buffer) zu.
LRESULT TCatIoGetOutputPtr (
USHORT nPort,
VOID** ppOutp,
int nSize
);
Parameter
nPort
Port ID des I/O Tasks, dessen Prozessabbild zum Transfer der Ausgabedaten benutzt werden sollte. Für weitere Informationen bezüglich der Definition der Prozessabbilder einer Task, siehe TwinCAT System Manager - Benutzerdefinierte Tasks.
ppOutp
Pointeradresse um die Adresse des Ausgabepuffers zu bekommen. Wenn TCatIoGetOutputPtr folgt, hat der Pointer die Adresse des Ausgangsdatenpuffers initialisiert.
nSize
Byteanzahl des angeforderten Prozessabbildpuffers.
Rückgabewert
Wenn die Funktion ausfällt, ist der Rückgabewert nicht Null.
Anmerkung
Die Funktion TCatIoGetOutputPtr ordnet dem Prozessabbild der spezifizierten Task einen Arbeitsspeicher zu und gibt die Adresse an ppOutp zurück. Wenn der Speicher bereits zugeordnet war, gibt TCatIoGetOutputPtr die Adresse des vorher zugeordneten Puffers zurück. Die Ausgabedaten werden durch diesen Puffer übertragen. Wenn TwinCAT gestoppt oder neu gestartet wird während der benutzerdefinierte Prozess läuft, bleibt die Ausgabe Adresse gültig, obwohl der I/O Transfer temporär gestoppt wird. Im Falle eines TwinCAT Neu Starts (Restart) kann der benutzerdefinierte Prozess die Ausführung ohne eine extra Berechnung wieder aufnehmen.
QuickInfo
Für Windows NT:
- Windows NT: Erforderliche Version 4.0 oder höher.
- TwinCAT: Erforderliche Version 2.5 oder höher.
- Header: Erklärt in TCatIoApi.h.
- Benutzte Import Bibliothek: TCatIoDrv.lib.
Für Windows CE:
- Windows CE Version: Erforderliche Version 4.2 oder höher.
- Image Version: Erforderliche version 1.90 oder höher.
- Header: Erklärt in TCatIoW32Api.h.
- Benutzte Import Bibliothek: TCatIoDrvW32.lib.