getminor-Subroutine für Einheitenkonfiguration
Zweck
Ruft die mit einer Hauptnummer verknüpften Nebennummern aus dem angepassten Gerätetreiber ab (CuDvDr ) Objektklasse.
Syntax
#include <cf.h>
#include <sys/cfgodm.h>
#include <sys/cfgdb.h>int major_no;
int * how_many;
char * device_instance;
Parameter
| Element | Beschreibung |
|---|---|
| Major_no | Gibt die Hauptnummer an, für die die entsprechende (n) Nebennummer (n) verwendet werden soll (n). |
| how_viele | Verweist auf die Anzahl der gefundenen untergeordneten Zahlen, die dem Parameter Major_no entsprechen. |
| Einheiteninstanz | Gibt einen Einheiteninstanznamen an, der bei der Suche nach untergeordneten Nummern verwendet werden soll Dieser Parameter wird zusammen mit dem Parameter Major_no verwendet. |
Beschreibung
Der Abonnieren Die Gerätekonfigurations-Subroutine ist eine der vorgesehenen Routinen für den Zugriff auf dieCuDvDr Objektklasse . Dieses Unterprogramm fragt dieCuDvDr Objektklasse für die Nebennummern, die mit der angegebenen Hauptnummer oder Geräteinstanz oder beidem verknüpft sind.
Wenn der Parameter Einheiteninstanz null ist, wird nur der Parameter Major_no verwendet, um die untergeordneten Zahlen abzurufen. Andernfalls sollten die Parameter Major_no und Einheiteninstanz verwendet werden. Die Anzahl der in der Abfrage gefundenen untergeordneten Zahlen wird im Parameter how_viele zurückgegeben.
DerCuDvDr Objektklasse wird ausschließlich durch den Abonnieren Unterprogramm für die Dauer der Routine.
Der Rückgabewert-Zeiger verweist auf eine Liste, die die der Hauptnummer zugeordneten Nebenzahlen enthält. Dieser Zeiger wird dann verwendet, um durch die Liste zu navigieren, um auf jede Nebennummer zuzugreifen. Die untergeordneten Zahlen werden in aufsteigender sortierter Reihenfolge zurückgegeben.
Die Subroutine GetMinor gibt auch die Anzahl der untergeordneten Zahlen in der Liste an die aufrufende Routine im Parameter how_viele zurück.
Rückgabewerte
Wenn die Routine GetMinor fehlschlägt, wird ein Nullzeiger zurückgegeben.
Wenn die Subroutine GetMinor erfolgreich ist, wird einer von zwei möglichen Werten zurückgegeben. Wenn keine untergeordneten Zahlen gefunden werden, wird null zurückgegeben. In diesem Fall zeigt der Parameter how_viele auf einen ganzzahligen Wert von 0. Wenn jedoch Nebennummern gefunden werden, wird ein Zeiger auf eine Liste mit Nebennummern zurückgegeben. Die untergeordneten Zahlen werden in aufsteigender sortierter Reihenfolge zurückgegeben. Im letzteren Fall verweist der Parameter how_viele auf die Anzahl der gefundenen untergeordneten Zahlen.
Dateien
| Element | Beschreibung |
|---|---|
| /usr/lib/libcfg.a | Archivierung von Einheitenkonfigurationssubroutinen. |