Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileFdup()
Fforce()
Fmidipipe()                                                          GEMDOS

Syntax

LONG Fmidipipe( pid, in, out )
WORD pid, in, out;

Function      Fmidipipe() is used to change the file handles used for MIDI
              input and output.

Opcode        294 (0x126)

Availability  Available when a 'MiNT' cookie with a version of at least
              0.90 exists.

Parameters    pid is the process id of the process whose MIDI devices you
              wish to alter. If pid is 0, then the current process will be
              modified. in specifies the GEMDOS file handle of the device
              to handle MIDI input. out specifies the GEMDOS file handle
              of the device to handle MIDI output.

Binding       move.w   out,-(sp)
              move.w   in,-(sp)
              move.w   pid,-(sp)
              move.w   #$126,-(sp)
              trap     #1
              addq.l   #8,sp

Return Value  Fmidipipe() returns a 0 if successful or a negative GEMDOS
              error code otherwise.

Comments      An Fmidipipe( 0, in, out ) call is essentially the same as:

              Fforce( -4, in);
              Fforce( -5, out);

              After this call, any Bconin() calls to MIDI device 5 will
              translate to a one character read from handle in. Likewise
              any Bconout() calls to MIDI device 5 will translate to a one
              character write to handle out.

See Also      Fdup(), Fforce()