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-File4.15.7  get_resource                                               TOS

 Name:         »Get Resource Data«

 Xbiosnummer:  316

 Deklaration:  int32_t get_resource ( int32_t handle );

 Beschreibung: Liefert sämtliche Infos zu den Resourcen einer PCI- 
               Karte (bzw. eines PCI-Gerätes im Fall von 
               Multifunktionskarten). Die zurückgelieferten Infos 
               dürfen von den Geräte-Treibern keinesfalls verändert 
               werden. Der Geräte-Treiber kann an Hand der angebotenen 
               Informationen (Byte ordering usw.) die Karte dann 
               direkt ansprechen. Eine weitere Möglichkeit ist die 
               Verwendung der BIOS-Routinen read_mem_..., 
               write_mem_..., read_io_... und write_io_..., wobei man 
               sich dann um keinerlei Nebenbedingungen selbst kümmern 
               muß.
               Die Routine liefert einen Zeiger auf den ersten 
               Resource Deskriptor des gewünschten PCI-Gerätes. Der 
               Geräte-Treiber kann dann die weiteren Deskriptoren über 
               einen Offset (Länge eines Deskriptors) erreichen. Der 
               letzte Deskriptor des Geräts ist wiederrum speziell 
               markiert. Die Reihenfolge der Despriptoren entspricht 
               derer der Basisadreßregister im PCI- 
               Konfigurationsbereich. Ein PCI-Gerät kann auch mehrere 
               Resourcen des gleichen Typs anfordern/verwenden.

                handle     Geräte-Handle des gewählten PCI-Gerätes

 Ergebnis:     positiv - Zeiger auf Resourcen-Informationen (erster 
               Deskriptor)
               negativ - PCI-BIOS Fehlercodes

 Verfügbar:    PCI-BIOS V2.00

 Gruppe:       PCI-BIOS

 Querverweis:  Binding