STOR_DEVICE_CAPABILITIES Struktur (srb.h)

Artikel
02/07/2025

Die STOR_DEVICE_CAPABILITIES Struktur meldet Gerätefunktionen an den SCSI-Porttreiber als Reaktion auf eine Funktionsabfrage in einem SCSI-Anforderungsblock (SRB) mit einer Funktion von SRB_FUNCTION_PNP. STOR_DEVICE_CAPABILITIES ist eine Teilmenge der DEVICE_CAPABILITIES Struktur, die die elemente enthält, die für Speichergeräte relevant sind.

Syntax

typedef struct _STOR_DEVICE_CAPABILITIES {
  USHORT Version;
  ULONG  DeviceD1 : 1;
  ULONG  DeviceD2 : 1;
  ULONG  LockSupported : 1;
  ULONG  EjectSupported : 1;
  ULONG  Removable : 1;
  ULONG  DockDevice : 1;
  ULONG  UniqueID : 1;
  ULONG  SilentInstall : 1;
  ULONG  SurpriseRemovalOK : 1;
  ULONG  NoDisplayInUI : 1;
} STOR_DEVICE_CAPABILITIES, *PSTOR_DEVICE_CAPABILITIES;

Angehörige

Version

Gibt die Version der Struktur an. Legen Sie den SCSI-Port auf STOR_DEVICE_CAPABILITIES_EX_VERSION_1 fest.

DeviceD1

Gibt an, ob die Gerätehardware den D1-Energiezustand unterstützt. Miniporttreiber legen dieses Bit auf 0 fest.

DeviceD2

Gibt an, ob die Gerätehardware den D2-Leistungszustand unterstützt. Miniporttreiber legen dieses Bit auf 0 fest.

LockSupported

Gibt an, ob das Gerät physische Sperrung unterstützt, die die Geräteauswurfsfunktion verhindert. Dieses Element bezieht sich auf das Auswerfen einer LUN oder eines Einheitsgeräts.

EjectSupported

Gibt an, ob das Gerät softwaregesteuerte Geräteauswurf unterstützt, während sich das System im PowerSystemWorking- Zustand befindet. Dieses Element bezieht sich auf das Auswerfen eines LUN- oder Einheitengeräts.

Removable

Gibt an, ob das Gerät dynamisch aus dem unmittelbaren übergeordneten Element entfernt werden kann. Wenn wechselbaren auf TRUE festgelegt ist:

Das Gerät gehört nicht zum gleichen physischen Objekt wie das übergeordnete Objekt.
Das Gerät wird im Programm "Unplug" oder "Eject Hardware" angezeigt, es sei denn, SurpriseRemovalOK auch auf TRUE festgelegt ist.

DockDevice

Gibt an, ob es sich bei dem Gerät um ein Docking-Peripheriegerät handelt.

UniqueID

Gibt an, ob die Instanz-ID des Geräts systemweit eindeutig ist. Dieses Bit ist klar, wenn die Instanz-ID nur innerhalb des Bereichs des Busses eindeutig ist.

SilentInstall

Gibt an, ob Geräte-Manager- alle Installationsdialogfelder unterdrücken soll; außer erforderlichen Dialogfeldern, z. B. "Keine kompatiblen Treiber gefunden".

SurpriseRemovalOK

Gibt an, ob der Miniporttreiber für das Gerät den Fall verarbeiten kann, in dem das Gerät entfernt wird, bevor der SCSI-Port SRB_FUNCTION_PNP mit StorRemoveDevice als PnPAction- in der SCSI_PNP_REQUEST_BLOCK Struktur senden kann. Wenn SurpriseRemovalOK- auf TRUEfestgelegt ist, kann das Gerät unabhängig vom Zustand, in dem sich der Treiber befindet, sicher von seinem unmittelbaren übergeordneten Element entfernt werden.

NoDisplayInUI

Zeigen Sie das Gerät nicht auf der Benutzeroberfläche an. Wenn dieses Bit festgelegt ist, wird das Gerät nie auf der Benutzeroberfläche angezeigt, auch wenn das Gerät vorhanden ist, aber nicht gestartet werden kann. Miniporttreiber legen dieses Bit nicht fest.

Bemerkungen

Wenn ein Miniporttreiber einen SRB in seiner HwStorStartIo Routine empfängt, in der die SRB-Funktion SRB_FUNCTION_PNP ist, wird der SRB als SCSI_PNP_REQUEST_BLOCK Struktur formatiert. Wenn das PnPAction Mitglied des SRB StorQueryCapabilitiesist, kann der Miniport eine STOR_DEVICE_CAPABILITIES Struktur im DataBuffer- Mitglied des SRB zurückgeben.

Der SCSI-Port sendet diese Struktur an den Miniport mit allen Membern, die auf 0 initialisiert wurden.

Ab Windows 8 sollten Miniports die STOR_DEVICE_CAPABILITIES_EX Struktur verwenden, um die Unterstützung für zusätzliche Funktionen anzugeben.