Avatar
www.fr-an.de

Hardwareinformationen

Alle unterstürzten Feature (Feature List)

GET CONFIGURATION Command - Operation Code $46

Multi-Media Commands - 6 Kapitel 6.5: Mit dem GET CONFIGURATION Command werden Informationen über die Eigenschaften des Laufwerkes ermittelt. Diese Eigenschaften können insgesamt oder einzeln abgerufen werden. Hier sollen alle unterstützten Feature ohne Auswertung ermittelt werden. Ein Teil der Feature werden immer unterstützt und bestimmte Feature bedingen, dass andere Feature und Commands unterstützt werden.

Der GET CONFIGURATION Command Descriptor Block:

  7 6 5 4 3 2 1 0
0 Operation Code ($46)
1 Reserviert RT = 00b
2 Starting Feature Number = $0000
3
4 Reserviert
5
6
7 Allocation Length = $1007
8
9 Control

 

Die zu setzenden Werte:

Byte 0 Operation Code - $46

Byte 1 RT - Request Type - 00b:

Wert Beschreibung
00b Das Laufwerk soll den Feature Header und alle durch das Laufwerk unterstützten Feature Beschreibungen zurückgeben ohne Rücksicht auf Geltung.
01b Das Laufwerk soll den Feature Header und nur die gewählte Feature Beschreibung zurückgeben.
10b Das Laufwerk soll den Feature Header und nur die gewählte Feature Beschreibung zurückgeben. Wird das Feature nicht unterstützt, soll nur der Feature Header zurückgegeben werden.
11b Reserviert

 
Byte 2 und 3 Starting Feature Number - $0000: Gibt die Nummer des Feature, welches zuerst ausgegeben werden soll, an. Da alle angezeigt werden sollen, wird die niedrigste mögliche Nummer angegeben.

Byte 7 und 8 Allocation Length - $1007: Länge der Antwortstruktur. Die Länge muss mindestens so groß gewählt werden, dass die erwartete Antwort auf jeden Fall hineinpasst. Da die Längenangabe der Antwortstruktur (Data Length) mit vier Byte doppelt so lang ist wie die angeforderte (Allocation Length) ist, ist das theoretisch nicht möglich. Man muss ein wenig probieren. Mit $1007 funktioniert die Ausführung. Wählt man einen zu großen Wert, bekommt man den Fehler Falscher Parameter. Die Antwort besteht nun wieder aus dem Feature Header:

  7 6 5 4 3 2 1 0
0 Data Length
1
2
3
4 Reserviert
5
6 Current Profile
7

 
Daran schließen sich alle unterstützten Feature Beschreibungen ohne weiteren Header an. Die ersten vier Byte der Feature Beschreibung beginnen wie folgt:

  7 6 5 4 3 2 1 0
0 Feature Code
1
2 Reserviert Version Persistent Current
3 Additional Length

 
Es folgen die Feature spezifischen Beschreibungen. Man kann diese entsprechend der Feature Nummer auswerten oder - da ihre Länge in Additional Length angegeben ist - zur nächsten Beschreibung weitergehen.

Einige Feature Beschreibungen sind auf diesen Seiten beschrieben:


Byte 9: Control - ?

Die Werte werden ein- und übertragen. Das Beispiel ist vielleicht etwas umständlich, aber übersichtlicher und eben nur ein Beispiel:

 
  const
    SCSIOP_GET_CONFIGURATION = $46;
    FEATURE_PROFILE_LIST     = $0000;
    RT_All                   = 0;
    RT_Current               = 1;
    RT_Identified            = 2;
 
  type
    TGET_CONFIGURATION_CDB = record
      OperationCode         : Byte;
      RequestType           : Byte;
      StartingFeatureNumber : Word;
      AllocationLength      : Word;
    end;
 
  type
    TGET_CONFIGURATION_LIST = record
      Header : array[0..$07] of Byte;
      Data   : array[0..$0FFF] of Byte;
    end;
 
    ...
 
  begin
 
    ...
 
    {
    *  Den Command Descriptor Block füllen.
    }
    ZeroMemory(@GET_CONFIGURATION_CDB, SizeOf(TGET_CONFIGURATION_CDB));
    GET_CONFIGURATION_CDB.OperationCode         := SCSIOP_GET_CONFIGURATION;
    GET_CONFIGURATION_CDB.RequestType           := RT_All;
    GET_CONFIGURATION_CDB.StartingFeatureNumber := FEATURE_PROFILE_LIST;
    GET_CONFIGURATION_CDB.AllocationLength      := SizeOf(TGET_CONFIGURATION_LIST);
    {
    *  Den Command Descriptor Block übertragen.
    }
    SetLength(aCDB, 10);
    aCDB[0] := GET_CONFIGURATION_CDB.OperationCode;
    aCDB[1] := GET_CONFIGURATION_CDB.RequestType;
    aCDB[2] := HiByte(GET_CONFIGURATION_CDB.StartingFeatureNumber);
    aCDB[3] := LoByte(GET_CONFIGURATION_CDB.StartingFeatureNumber);
    aCDB[7] := HiByte(GET_CONFIGURATION_CDB.AllocationLength);
    aCDB[8] := LoByte(GET_CONFIGURATION_CDB.AllocationLength);
 
    ...
 
  end;

 

Ausführung und Auswertung

Nach der Ausführung wird die Antwortstruktur ausgewertet.

 
  type
    TGetConfigurationHeader = record
      DataLength     : DWord;
      CurrentProfile : Word;
    end;
 
    TFeature = record
      FeatureCode : Word;
      Version     : Byte;
      Persistent  : Boolean;
      Current     : Boolean;
    end;
 
  var
    FeatureList : array of TFeature;
 
    ...
 
  begin
 
    ...
 
    {
    *  Befehl ausführen
    }
    if GET_SCSI_PASS_THROUGH_DIRECT(aDrive, aCDB, @GET_CONFIGURATION_LIST,
                                    SizeOf(TGET_CONFIGURATION_LIST))
    then begin
      ConfigHeader.DataLength     := GET_CONFIGURATION_LIST.Header[0] shl 24 or
                                     GET_CONFIGURATION_LIST.Header[1] shl 16 or
                                     GET_CONFIGURATION_LIST.Header[2] shl  8 or
                                     GET_CONFIGURATION_LIST.Header[3];
      ConfigHeader.CurrentProfile := GET_CONFIGURATION_LIST.Header[6] shl 8 or
                                     GET_CONFIGURATION_LIST.Header[7];
 
      nByte := 0;
      while ConfigHeader.DataLength > nByte + 4
      do begin
        nFeature := Length(FeatureList);
        SetLength(FDrive[FActive].FeatureList, nFeature + 1);
        with FeatureList[nFeature]
        do begin
          FeatureCode := GET_CONFIGURATION_LIST.Data[nByte + 0] shl 8 or
                         GET_CONFIGURATION_LIST.Data[nByte + 1];
          Version     := GET_CONFIGURATION_LIST.Data[nByte + 2] and $3C shr 2;
          Persistent  := GET_CONFIGURATION_LIST.Data[nByte + 2] and $02 > 0;
          Current     := GET_CONFIGURATION_LIST.Data[nByte + 2] and $01 > 0;
        end;
        nLength := GET_CONFIGURATION_LIST.Data[nByte + 3] + 4;
        inc(nByte, nLength);
      end;
 
      ...
 
    end;
  end;

 
Data Length - Die Datenlänge im Header gibt die Länge des noch folgenden Headerrestes und der Feature Beschreibungen an. Der Wert ist ein Vielfaches von vier.

Current Profile - Gibt das aktive Profil an. Das Profil ist vom Laufwerk und dem eingelegten Datenträger abhängig. Sind mehrere Profile aktiv wird das Profil mit der höchsten Nummer angegeben. (Liste der Profile in einem Fenster öffnen.)

Feature Code - Gibt die Nummer des unterstützen Features, dessen Beschreibung nun folgt, an.

Version - Die Versionsnummer ist von unterstützten Standard und dem Teature abhängig.

Persistent und Current geben an, ob das Feature geändert werden kann und ob es zur Zeit aktiv ist.

Additional Length - Der Wert muss ein vielaches von vier betragen, weil die Profile Descriptoren immer ein vielfaches von vier Byte lang sind.

 

Demo, welche diese Funktion nutzt:

Hardware Feature List (podHardFeature.7z - 260 kb) MD5 (1 kb). Stand: 27. Januar 2012

Änderungen an der Demo

27.01.2012 -
Fehler: Beim Speichern war eine Änderung nicht übernommen worden.

 

Fr_An - Erstellt: 14. Januar 2012 - Letzte Änderung: 22. Januar 2012

seit 28. Juli 2010