struktur STOR_DEVICE_CAPABILITIES_EX (minitape.h)

Struktur STOR_DEVICE_CAPABILITIES_EX 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_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. Storport mengatur bidang ini ke STOR_DEVICE_CAPABILITIES_EX_VERSION_1.

Size

Menentukan ukuran struktur. Storport mengatur bidang ini ke sizeof(STOR_DEVICE_CAPABILITIES_EX).

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."

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 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.

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 sebelum memanggil StorPortInitialize.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Header	minitape.h (termasuk Storport.h, Minitape.h, Srb.h)

Lihat juga

DEVICE_CAPABILITIES

HW_INITIALIZATION_DATA SCSI_PNP_REQUEST_BLOCK

StorPortInitialize