Topic       : MIDI_COM Dokumentation
Author      : H. Blees
Version     : MIDI_COM.hyp (21/5/1997)
Subject     : Dokumentation/MIDI_COM
Nodes       : 125
Index Size  : 3066
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : 
@help       : 
@options    : +g -i -n +y +z -t4 -d10
@width      : 75
View Ref-FileLibrary                                                           MIDI_COM

typedef verwaltung procs[7];        /* Verwaltungsstruktur            */
typedef procs     (*all_proc);      /* Zeiger auf Verwaltungsstruktur */

extern      int   anmeld_ringextern      int   anmeld_ring(char *name,int buff_size) 

Anmelden einer Applikation an MIDI_COM. 

Parameter:
name:       Name der Applikation, maximal 8 Zeichen.
buff_size:  Größe des gewünschten Empfangspuffers. Dieser 
            wird durch die  LIB über MALLOC angefordert und 
            bei Bedarf passend gerundet.
Returnwert:  TRUE, wenn die Anmeldung durchgeführt 
                           werden konnte.
                     FALSE sonst
(char *name,int buff_size);
extern      void  abmeld_ringextern      void  abmeld_ring(void)

Abmelden der Applikation.
Der Empfangs-Puffer wird wieder freigegeben. Dieser Aufruf 
sollte vor Programmende auf jeden Fall durchgeführt werden.
(void);
extern      long  transmitextern long transmit(int size,int an,char *name,void *dat_ad

Senden eines Datensatzes an einen oder mehrere Empfänger.

Parameter:
size:       Länge der Daten in Bytes
an:         Adresse des Empfängers.
name:       Name des Empfängers.
dat_adr:    Anfangsadresse der zu Übertragenden Daten
Returnwert:  TRUE, wenn die Übertragung 
                           durchgeführt werden konnte.
                     FALSE sonst
(int size,int an,char *name,void *dat_adr);
extern      int   leseextern      int   lese(char *bufa1,int *esc,int *len);

Auslesen des Empfangs-Puffers in einen eigenen Datenbereich.

Parameter:
bufa1:      Speicherbereich, in den die Daten gelesen 
            werden sollen.
esc:        Kennzeichnung für interne Nachrichten
len:        Länge der Empfangenen Nachricht
Returnwert:  TRUE, wenn eine Nachricht empfangen 
                           wurde.
                     FALSE sonst
(char *bufa1,int *esc,int *len);
extern      void  set_unitimeextern      void  set_unitime(void);

Das aktuelle Datum und die aktuelle Uhrzeit werden auf 
allen anderen Rechnern gesetzt.

(void);
extern      int   get_prconfextern      int   get_prconf(void)

Auslesen der aktuell erlaubten Drucker.

Returnwert:
      Bitpattern mit erlaubten Druckern

(void)
extern      void  set_prconfextern      void  set_prconf(int conf);

Setzen der erlaubten Drucker

Parameter:
conf:       Bitpattern mit erlaubten Druckern

(int conf);
extern      int   mc_busyextern      int   mc_busy(void);

Eine Nachricht ist noch aktiv. Das Netz ist "beschäftigt".

Returnwert:
 TRUE, wenn eine Nachricht noch in Arbeit ist.
 FALSE sonst

(void);
extern      int   mc_closedextern      int   mc_closed(void);

Abfrage, ob MIDI_COM arbeitet.

Returnwert:
 TRUE, wenn MIDI_COM mindestens eine Empfangsstation 
       erreichen kann.
 FALSE sonst


(void);
extern      int   mc_neustatextern      int   mc_neustat(void);

Prüft, ob der Aufruf get_Karte durchgeführt werden sollte.

Returnwert:
 TRUE, wenn sich der Netzstatus verändert hat.
 FALSE sonst


(void);
extern      int   get_Karteextern      int   get_Karte(all_proc karte);

Kopieren der Verwaltungsstruktur in einen eigenen 
Speicherbereich. Dabei ist der erste Eintrag vom Rechner 
"0", der nächste vom Rechner "1" usw.

Returnwert:
 TRUE, Aktion durchgeführt.
 FALSE sonst


(all_proc karte);
extern      int   get_LWextern      int   get_LW(void);

Nummer des Laufwerks, das als Netzlaufwerk für MIDI_COM 
eingestellt ist.

Returnwert:
 Nummer des Netzlaufwerks


(void);
extern      int   relative_reply(int an);
extern      int   get_relativeextern      int   get_relative(int absolut);

Ermitteln der relativen Adresse aus einer Absoluten.

Parameter:
absolut:    Absolute Adresse

Returnwert:
 relative Adresse


(int absolut);
extern      int   get_absolutextern      int   get_absolut(int   relativ);

Ermitteln der absoluten Adresse aus einer Relativen.

Parameter:
relativ:    relative Adresse

Returnwert:
 absolute Adresse


(int   relativ);