Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File14.8.5.19  XHReserve                                               TOS

 Name:         »XHReserve« - Reserve a device, or release it again.

 Opcode:       2

 Syntax:       LONG XHReserve ( UWORD major, UWORD minor, UWORD 
               do_reserve, UWORD key );

 Description:  XHReserve reserves or releases a device. XHLock, XHStop 
               and XHEject only work for reserved devices if the 
               correct key parameter is passed.

               Example: Take a virtual memory manager which has locked 
               a removable hard disk with the swap partition. You 
               don't want the user to be able to unlock this device 
               with a CPX module!

                Parameter  Meaning

                do_reserve
                            (1)  Reserve
                            (0)  Release
                key        Only used for release

 Return value: On success, a 16-bit key different from 0 is returned. 
               This key must be specified for all further accesses to 
               the device, as well as for releasing it again.

 Group:        XHDI functions

 See Also:     Arbitration   _drvbits   Partition types 
               System variables   XHDI cookie   XHDI terminology