struktur STOR_DEVICE_CAPABILITIES (minitape.h)
Struktur STOR_DEVICE_CAPABILITIES melaporkan kemampuan perangkat ke driver Storport 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. Storport mengatur bidang ini ke STOR_DEVICE_CAPABILITIES_EX_VERSION_1.
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.
Jika Dapat Dilepas diatur ke TRUE, 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 Storport 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.
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 SRB adalah StorQueryCapabilities, miniport dapat mengembalikan struktur STOR_DEVICE_CAPABILITIES di anggota DataBuffer SRB.
Storport mengirimkan struktur ini ke miniport dengan semua anggota diinisialisasi ke 0. Saat kembali, hanya bidang Yang Dapat Dilepas yang digunakan dari struktur ini.
Dimulai dengan Windows 8, miniport harus menggunakan struktur STOR_DEVICE_CAPABILITIES_EX untuk menunjukkan dukungan untuk kemampuan tambahan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows Vista. |
Header | minitape.h (termasuk Storport.h, Minitape.h, Srb.h) |