Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.12.4  Mshrink                                                    TOS

 Name:         »memory shrink« - Speicherbereich verkürzen oder 
               vergrößern.

 Gemdosnummer: 74

 Deklaration:  int32_t Mshrink ( void *block, int32_t newsiz );

 Beschreibung: Die GEMDOS-Routine Mshrink verkürzt oder vergrößert 
               einen bereits reservierten Speicherbereich. Es gilt:

                Parameter  Bedeutung

                block      Anfangsadresse des Speicherblocks
                newsiz     neue (geänderte) Länge des Blocks; in MagiC 
                           zusätzlich:
                            -1 =  ermitteln der größtmöglichen Größe 
                                  des Speicherblocks
                             0 =  Block freigeben

               Hinweis: Es wird i.d.R. nicht überprüft, ob der 
               Speicherblock dem Aufrufer überhaupt gehört. Die 
               Möglichkeit einen Speicherblock zu vergrößern, steht 
               z.Zt. nur in MagiC zur Verfügung. Allerdings 
               funktioniert dies nur, wenn über dem betreffenden Block 
               ein genügend großer freier Block vorhanden ist, und die 
               TOS-Kompatibilität deaktiviert wurde.

 Ergebnis:     Die Funktion liefert folgende Resultate:

                E_OK :   kein Fehler aufgetreten
                EIMBA :  falsche Blockadresse
                EGSBF :  Block würde vergrößert

 Verfügbar:    Alle GEMDOS Versionen.

 Gruppe:       Speicherverwaltung

 Querverweis:  Binding   Malloc   Mfree