struktur STOR_DEVICE_CAPABILITIES (srb.h)

Artikel
08/07/2023

Struktur STOR_DEVICE_CAPABILITIES melaporkan kemampuan perangkat ke driver port SCSI sebagai respons terhadap kueri kemampuan di blok permintaan SCSI (SRB) dengan fungsi SRB_FUNCTION_PNP. STOR_DEVICE_CAPABILITIES adalah subset dari struktur DEVICE_CAPABILITIES yang berisi anggota yang relevan dengan perangkat penyimpanan.

Sintaks

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;

Anggota

Version

Menentukan versi struktur. Atur ke STOR_DEVICE_CAPABILITIES_EX_VERSION_1 oleh port SCSI.

DeviceD1

Menentukan apakah perangkat keras perangkat mendukung status daya D1. Driver Miniport mengatur bit ini ke 0.

DeviceD2

Menentukan apakah perangkat keras perangkat mendukung status daya D2. Driver Miniport mengatur bit ini ke 0.

LockSupported

Menentukan apakah perangkat mendukung penguncian perangkat fisik yang mencegah ejeksi perangkat. Anggota ini berkaitan dengan mengeluarkan LUN atau perangkat unit.

EjectSupported

Menentukan apakah perangkat mendukung ejeksi perangkat yang dikontrol perangkat lunak saat sistem berada dalam status PowerSystemWorking . Anggota ini berkaitan dengan mengeluarkan LUN atau perangkat unit.

Removable

Menentukan apakah perangkat dapat dihapus secara dinamis dari induk langsungnya. Jika Dapat Dilepas diatur ke TRUE:

Perangkat bukan milik objek fisik yang sama dengan induknya.
Perangkat ditampilkan dalam program Cabut atau Keluarkan Perangkat Keras, kecuali SurpriseRemovalOK juga diatur ke TRUE.

DockDevice

Menentukan apakah perangkat adalah periferal docking.

UniqueID

Menentukan apakah ID instans perangkat unik di seluruh sistem. Bit ini jelas jika ID instans hanya unik dalam cakupan bus.

SilentInstall

Menentukan apakah Manajer Perangkat harus menekan semua kotak dialog penginstalan; kecuali kotak dialog yang diperlukan seperti "tidak ada driver kompatibel yang ditemukan."

SurpriseRemovalOK

Menentukan apakah driver miniport untuk perangkat dapat menangani kasus di mana perangkat dihapus sebelum port SCSI dapat mengirim SRB_FUNCTION_PNP dengan StorRemoveDevice sebagai PnPAction dalam struktur SCSI_PNP_REQUEST_BLOCK . Jika SurpriseRemovalOK diatur ke TRUE, perangkat dapat dihapus dengan aman dari induk langsungnya terlepas dari status drivernya.

NoDisplayInUI

Jangan tampilkan perangkat di antarmuka pengguna. Jika bit ini diatur, perangkat tidak pernah ditampilkan di antarmuka pengguna, bahkan jika perangkat ada tetapi gagal untuk memulai. Driver Miniport tidak mengatur bit ini.

Keterangan

Ketika driver miniport menerima SRB dalam rutinitas HwStorStartIo di mana fungsi SRB SRB_FUNCTION_PNP, SRB diformat sebagai struktur SCSI_PNP_REQUEST_BLOCK . Jika anggota PnPAction dari SRB adalah StorQueryCapabilities, miniport dapat mengembalikan struktur STOR_DEVICE_CAPABILITIES di anggota DataBuffer dari SRB.

Port SCSI mengirimkan struktur ini ke miniport dengan semua anggota diinisialisasi ke 0.

Dimulai dengan Windows 8, miniport harus menggunakan struktur STOR_DEVICE_CAPABILITIES_EX untuk menunjukkan dukungan untuk kemampuan tambahan.