IMGetChannels

Autor: Alexander Berger
Headerdatei: ims.h

Prototyp
Retcode_t API_FUNCTION IMGetChannels(
   UInt32_t     bufferSize,
   IMChannel_s* channelInfos,
   UInt32_t*    usedBufferSize );

Kurzbeschreibung
Diese Funktion ermittelt alle Übertragungskanäle, die es im aktuellen IMS-System gibt.

Parameter
bufferSize - Gibt an, wieviele IMChannel_s-Strukturen der Puffer aufnehmen kann.

channelInfos - Zeiger auf einen Puffer, der die IMChannel_s-Strukturen aufnehmen kann.

usedBufferSize - Zeiger auf eine 32-Bit Zahl. Diese Zahl enthält bei Erfolg die Anzahl der tatsächlich gelesenen IMChannel_s-Strukturen bzw. beim Rückgabewert RC_MORE_DATA die benötigte Größe des Puffers (in Anzahl von IMChannel_s-Strukturen).

Rückgabewert:
Sind alle Kanalinformationen in den Puffer kopiert worden, RC_SUCCESS. Wenn der Puffer nicht groß genug war, dann RC_MORE_DATA. Bei anderen Fehlern wird ein in 'errdefs.h' definierter Fehlercode zurückgegeben.

Anmerkungen:
Keine