Avatar
www.fr-an.de

Hardwareinformationen

Removable Medium

GET CONFIGURATION Command - Operation Code $46
REMOVABLE MEDIUM FEATURE - Feature Number $0003

Multi-Media Commands - 6 Kapitel 6.5: Mit dem GET CONFIGURATION Command werden Informationen über die Eigenschaften des Laufwerkes ermittelt. Die Eigenschaften können insgesamt oder einzeln abgerufen werden. Das REMOVABLE MEDIUM Feature ist optional, sollte bei optischen Laufwerken jedoch vorhanden sein.

Der GET CONFIGURATION Command Descriptor Block:

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

 

Die zu setzenden Werte:

Byte 0: Operation Code - $46

Byte 1: RT - Request Type:

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 - Gibt die Nummer des Feature, welches zuerst ausgegeben werden soll, an. Abhängig vom Request Type kann es auch das einzige sein.

Byte 7 und 8: Länge der Antwortstruktur. Die Länge muss mindestens so groß gewählt werden, dass die erwartete Antwort auf jeden Fall hineinpasst. Hier ist es das REMOVABLE MEDIUM Feature mit der Feature Nummer $0003. Der Header ist acht Byte und die Feature Beschreibung ebenfalls acht Byte lang, so dass die Länge mindestens 16 beträgt.

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_REMOVABLE_MEDIUM = $0003;
    RT_All                   = 0;
    RT_Current               = 1;
    RT_Identified            = 2;
 
  type
    TGET_CONFIGURATION_CDB = record
      OperationCode         : Byte;
      RequestType           : Byte;
      StartingFeatureNumber : Word;
      AllocationLength      : Word;
    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_Identified;
    GET_CONFIGURATION_CDB.StartingFeatureNumber := FEATURE_REMOVABLE_MEDIUM;
    GET_CONFIGURATION_CDB.AllocationLength      := SizeOf(TGET_CONFIGURATION_REMO);
    {
    *  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;

 

Die Antwortstruktur - Removable Medium Feature:

Diese Struktur sollte 16 Byte lang sein. Wenn das Feature nicht unterstützt würde, wäre der Wert nur acht. Zuerst der Feature Header:

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

 
Anschließend die Removable Medium Feature Beschreibung, falls dieses Feature unterstützt wird:

  7 6 5 4 3 2 1 0
0 Feature Code = $0003
1
2 Reserviert Version = 0010b Persistent Current
3 Additional Length = 4
4 Loading Mechanism Type Load Eject Pvnt Jmpr DBML Lock
5 Reserviert
6
7 
 
  type
    TGET_CONFIGURATION_REMO = record
      Header : array[0..7] of Byte;
      Data   : array[0..7] of Byte;
    end;

 

Ausführung und Auswertung

Nach der Ausführung wird die Antwortstruktur ausgewertet.

 
  type
    TGetConfigurationHeader = record
      DataLength     : DWord;
      CurrentProfile : Word;
    end;
 
    TFeatureRemovable = record
      FeatureCode  : Word;
      Version      : Byte;
      Persistent   : Boolean;
      Current      : Boolean;
      AddLength    : Byte;
      LoadMechType : Byte;
      Load         : Boolean;
      Eject        : Boolean;
      PvntJmpr     : Boolean;
      DBML         : Boolean;
      Lock         : Boolean;
    end;
 
    ...
 
  begin
 
    ...
 
    {
    *  Befehl ausführen
    }
    if GET_SCSI_PASS_THROUGH_DIRECT(aDrive, aCDB, @GET_CONFIGURATION_REMOVABLE,
                                    SizeOf(TGET_CONFIGURATION_REMO))
    then begin
      ConfigHead.DataLength     := GET_CONFIGURATION_REMOVABLE.Header[0] shl 24 or
                                   GET_CONFIGURATION_REMOVABLE.Header[1] shl 16 or
                                   GET_CONFIGURATION_REMOVABLE.Header[2] shl  8 or
                                   GET_CONFIGURATION_REMOVABLE.Header[3];
      ConfigHead.CurrentProfile := GET_CONFIGURATION_REMOVABLE.Header[6] shl 8 or
                                   GET_CONFIGURATION_REMOVABLE.Header[7];
      Removable.FeatureCode  := GET_CONFIGURATION_REMOVABLE.Data[0] shl 8 or
                                GET_CONFIGURATION_REMOVABLE.Data[1];
      Removable.Version      := GET_CONFIGURATION_REMOVABLE.Data[2] and $3C shr 2;
      Removable.Persistent   := GET_CONFIGURATION_REMOVABLE.Data[2] and $02 > 0;
      Removable.Current      := GET_CONFIGURATION_REMOVABLE.Data[2] and $01 > 0;
      Removable.AddLength    := GET_CONFIGURATION_REMOVABLE.Data[3];
      Removable.LoadMechType := GET_CONFIGURATION_REMOVABLE.Data[4] shr 5;
      Removable.Load         := GET_CONFIGURATION_REMOVABLE.Data[4] and $10 > 0;
      Removable.Eject        := GET_CONFIGURATION_REMOVABLE.Data[4] and $08 > 0;
      Removable.PvntJmpr     := GET_CONFIGURATION_REMOVABLE.Data[4] and $04 > 0;
      Removable.DBML         := GET_CONFIGURATION_REMOVABLE.Data[4] and $02 > 0;
      Removable.Lock         := GET_CONFIGURATION_REMOVABLE.Data[4] and $01 > 0;
    end;
 
    ...
 
  end;

 

Data Length - Die Datenlänge im Header gibt die Länge des noch folgenden Headerrestes und der Feature Bechreibungen an. Hier müsste der Wert 12 betragen weil noch vier Byte Header und acht Byte Feature Removable Medium Beschreibung folgen.

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 - Muss der selbe wie im CDB sein. Hier war das Removable Medium Feature $0003 ausgewählt.

Version - Die Versionsnummer muss 0010b sein.

Persistent und Current müssen jeweils 1b sein.

Additional Length - Der Wert muss vier betragen, weil noch vier Byte der Feature Beschreibung folgen.

Loading Mechanism Type - Die Werte entsprechen denen bei Capabilities:

Loading Mechanism Type Beschreibung
000b Caddy/Slot type loading mechanism
001b Tray type loading mechanism
010b Pop-up type loading mechanism
011b Reserved
100b Embedded changer with individually changeable discs
101b Embedded changer using a magazine mechanism
110b – 111b Reserved

 
Load - Gibt an, ob das Medium über das START STOP UNIT command mit dem LoEj Bit geladen werden kann.

Eject - Gibt an, ob das Medium über das START STOP UNIT command mit dem LoEj Bit ausgeworfen werden kann.

Pvnt Jmpr - Prevent Jumper. Wenn gesetzt, dann ist kein Prevent Jumper vorhanden.

DBML - Gibt an, ob beim Laden/Entladen des Laufwerkes Device Busy Events gemeldet werden.

Lock - Gibt an, ob das Laufwerk gesperrt werden kann.

 

Demo, welche diese Funktion nutzt:

Hardware Removable (podHardRemo.7z - 256 kb) MD5 (1 kb). Stand: 10. Januar 2012

 

Fr_An - Erstellt: 8.Januar 2012 - Letzte Änderung: 21. Januar 2012

seit 28. Juli 2010