struktur STOR_DEVICE_CAPABILITIES_EX (storport.h)

  • Artikel

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.

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

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 untuk memulai. 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 angka yang terkait dengan perangkat yang dapat ditampilkan di antarmuka pengguna.

Nomor ini mungkin merupakan nilai ID yang dipilih untuk membuat lokasi perangkat fisik lebih mudah bagi pengguna. Ketika UINumber tidak diketahui, driver miniport dapat mengatur anggota ini ke nilai default 0xFFFFFFFF.

Reserved1[2]

Bit yang dipesan.

Keterangan

STOR_DEVICE_CAPABILITIES_EX adalah subset dari struktur DEVICE_CAPABILITIES yang berisi anggota yang relevan dengan perangkat penyimpanan.

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

Karakteristik keluarkan, penghapusan, dan penginstalan 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 storport.h (termasuk Storport.h, Minitape.h, Srb.h)

Lihat juga

DEVICE_CAPABILITIES

HW_INITIALIZATION_DATA

SCSI_PNP_REQUEST_BLOCK

StorPortInitialize