struktur STOR_DEVICE_CAPABILITIES_EX (srb.h)
Struktur STOR_DEVICE_CAPABILITIES_EX 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_EX {
USHORT Version;
USHORT Size;
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 RawDeviceOK : 1;
ULONG SurpriseRemovalOK : 1;
ULONG NoDisplayInUI : 1;
ULONG DefaultWriteCacheEnabled : 1;
ULONG Reserved0 : 20;
ULONG Address;
ULONG UINumber;
ULONG Reserved1[2];
} STOR_DEVICE_CAPABILITIES_EX, *PSTOR_DEVICE_CAPABILITIES_EX;
Anggota
Version
Menentukan versi struktur. Atur ke STOR_DEVICE_CAPABILITIES_EX_VERSION_1 oleh Storport.
Size
Menentukan ukuran struktur. Atur ke sizeof(STOR_DEVICE_CAPABILITIES_EX) oleh Storport.
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 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."
RawDeviceOK
Menentukan apakah driver untuk bus yang mendasar dapat mendorong perangkat jika tidak ada driver fungsi (misalnya, perangkat SCSI dalam mode pass-through). Mode operasi ini disebut mode mentah.
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 dimulai. Driver miniport tidak mengatur bit ini.
DefaultWriteCacheEnabled
Cache tulis perangkat penyimpanan diaktifkan secara default pada inisialisasi.
Reserved0
Bit yang dipesan.
Address
Alamat LUN perangkat unit penyimpanan.
UINumber
Menentukan nomor yang terkait dengan perangkat yang dapat ditampilkan di antarmuka pengguna.
Angka ini mungkin merupakan nilai ID yang dipilih untuk mempermudah penemuan perangkat fisik bagi pengguna. Ketika UINumber tidak diketahui, driver miniport dapat mengatur anggota ini ke nilai default 0xFFFFFFFF.
Reserved1[2]
Bit yang dipesan.
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_EX di anggota DataBuffer SRB.
Karakteristik eject, removal, dan install untuk perangkat diatur dalam struktur STOR_DEVICE_CAPABILITIES_EX . Untuk mendukung penggunaan struktur ini, miniport harus mengatur bendera STOR_FEATURE_FULL_PNP_DEVICE_CAPABILITIES di anggota bendera FeatureSupport di HW_INITIALIZATION_DATA (SCSI) sebelum memanggil ScsiPortInitialize.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 8. |
Header | srb.h (termasuk Storport.h, Minitape.h, Srb.h) |