struttura STOR_DEVICE_CAPABILITIES (minitape.h)
La struttura STOR_DEVICE_CAPABILITIES segnala le funzionalità del dispositivo al driver Storport in risposta a una query sulle funzionalità in un blocco di richieste SCSI (SRB) con una funzione di SRB_FUNCTION_PNP. STOR_DEVICE_CAPABILITIES è un subset della struttura di DEVICE_CAPABILITIES contenente i membri rilevanti per i dispositivi di archiviazione.
Sintassi
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;
Membri
Version
Specifica la versione della struttura. Storport imposta questo campo su STOR_DEVICE_CAPABILITIES_EX_VERSION_1.
DeviceD1
Specifica se l'hardware del dispositivo supporta lo stato di alimentazione D1. I driver Miniport impostano questo bit su 0.
DeviceD2
Specifica se l'hardware del dispositivo supporta lo stato di alimentazione D2. I driver Miniport impostano questo bit su 0.
LockSupported
Specifica se il dispositivo supporta il blocco fisico del dispositivo che impedisce l'espulsione del dispositivo. Questo membro riguarda l'espellezione di un LUN o di un dispositivo di unità.
EjectSupported
Specifica se il dispositivo supporta l'eiezione di dispositivi controllati dal software mentre il sistema si trova nello stato PowerSystemWorking. Questo membro riguarda l'espellezione di un dispositivo LUN o unità.
Removable
Specifica se il dispositivo può essere rimosso dinamicamente dal relativo elemento padre immediato. Se rimovibile è impostato su TRUE, il dispositivo non appartiene allo stesso oggetto fisico del padre.
Se rimovibile è impostato su TRUE, il dispositivo viene visualizzato nel programma Unplug o Eject Hardware, a meno che SurpriseRemovalOK sia impostato anche su TRUE.
DockDevice
Specifica se il dispositivo è una periferica di ancoraggio.
UniqueID
Specifica se l'ID istanza del dispositivo è univoco a livello di sistema. Questo bit è chiaro se l'ID istanza è univoco solo nell'ambito del bus.
SilentInstall
Specifica se gestione dispositivi deve eliminare tutte le finestre di dialogo di installazione; ad eccezione delle finestre di dialogo richieste, ad esempio "nessun driver compatibile trovato".
SurpriseRemovalOK
Specifica se il driver miniport per il dispositivo può gestire il caso in cui il dispositivo viene rimosso prima che Storport possa inviare SRB_FUNCTION_PNP con StorRemoveDevice come PnPAction nella struttura SCSI_PNP_REQUEST_BLOCK. Se SurpriseRemovalOK è impostato su TRUE, il dispositivo può essere rimosso dal relativo elemento padre immediato indipendentemente dallo stato in cui si trova il driver.
NoDisplayInUI
Non visualizzare il dispositivo nell'interfaccia utente. Se questo bit è impostato, il dispositivo non viene mai visualizzato nell'interfaccia utente, anche se il dispositivo è presente ma non viene avviato. I driver Miniport non impostano questo bit.
Osservazioni
Quando un driver miniport riceve un SRB nel relativo HwStorStartIo routine in cui la funzione SRB è SRB_FUNCTION_PNP, la struttura SRB viene formattata come struttura SCSI_PNP_REQUEST_BLOCK. Se il membro PnPAction di SRB è StorQueryCapabilities, il miniport può restituire una struttura STOR_DEVICE_CAPABILITIES nel membro DataBuffer di SRB.
Storport invia questa struttura al miniport con tutti i membri inizializzati su 0. In caso di restituzione, da questa struttura viene utilizzato solo il campo rimovibile.
A partire da Windows 8, i miniport devono usare la struttura STOR_DEVICE_CAPABILITIES_EX per indicare il supporto per funzionalità aggiuntive.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows Vista. |
| intestazione | minitape.h (include Storport.h, Minitape.h, Srb.h) |