Compartir a través de


estructura STOR_DEVICE_CAPABILITIES (storport.h)

La estructura STOR_DEVICE_CAPABILITIES notifica las funcionalidades del dispositivo al controlador Storport en respuesta a una consulta de funcionalidades en un bloque de solicitudes SCSI (SRB) con una función de SRB_FUNCTION_PNP. STOR_DEVICE_CAPABILITIES es un subconjunto de la estructura de DEVICE_CAPABILITIES que contiene los miembros pertinentes para los dispositivos de almacenamiento.

Sintaxis

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;

Miembros

Version

Especifica la versión de la estructura. Establezca en STOR_DEVICE_CAPABILITIES_EX_VERSION_1 por Storport.

DeviceD1

Especifica si el hardware del dispositivo admite el estado de alimentación D1. Los controladores de minipuerto establecen este bit en 0.

DeviceD2

Especifica si el hardware del dispositivo admite el estado de alimentación D2. Los controladores de minipuerto establecen este bit en 0.

LockSupported

Especifica si el dispositivo admite el bloqueo de dispositivos físicos que impide la expulsión del dispositivo. Este miembro pertenece a la expulsión de un LUN o un dispositivo de unidad.

EjectSupported

Especifica si el dispositivo admite la expulsión de dispositivos controlados por software mientras el sistema está en estado PowerSystemWorking . Este miembro pertenece a la expulsión de un LUN o un dispositivo de unidad.

Removable

Especifica si el dispositivo se puede quitar dinámicamente de su elemento primario inmediato. Si Removable está establecido en TRUE, el dispositivo no pertenece al mismo objeto físico que su elemento primario.

Si Removable está establecido en TRUE, el dispositivo se muestra en el programa Desconectar o expulsar hardware, a menos que SurpriseRemovalOK también esté establecido en TRUE.

DockDevice

Especifica si el dispositivo es un periférico de acoplamiento.

UniqueID

Especifica si el identificador de instancia del dispositivo es único en todo el sistema. Este bit está claro si el identificador de instancia es único solo dentro del ámbito del bus.

SilentInstall

Especifica si Administrador de dispositivos debe suprimir todos los cuadros de diálogo de instalación; excepto los cuadros de diálogo necesarios, como "no se encontraron controladores compatibles".

SurpriseRemovalOK

Especifica si el controlador de miniport para el dispositivo puede controlar el caso en el que se quita el dispositivo antes de que Storport pueda enviar SRB_FUNCTION_PNP con StorRemoveDevice como PnPAction en la estructura de SCSI_PNP_REQUEST_BLOCK . Si SurpriseRemovalOK está establecido en TRUE, el dispositivo se puede quitar de forma segura de su elemento primario inmediato, independientemente del estado en el que se encuentra su controlador.

NoDisplayInUI

No muestre el dispositivo en la interfaz de usuario. Si se establece este bit, el dispositivo nunca se muestra en la interfaz de usuario, incluso si el dispositivo está presente, pero no se inicia. Los controladores de minipuerto no establecen este bit.

Comentarios

Cuando un controlador de minipuerto recibe un SRB en su rutina HwStorStartIo donde se SRB_FUNCTION_PNP la función SRB, la SRB tiene el formato de estructura SCSI_PNP_REQUEST_BLOCK . Si el miembro PnPAction del SRB es StorQueryCapabilities, el miniporte puede devolver una estructura de STOR_DEVICE_CAPABILITIES en el miembro DataBuffer del SRB.

Storport envía esta estructura al miniport con todos los miembros inicializados en 0. Al devolver, solo se utiliza el campo Extraíble de esta estructura.

A partir de Windows 8, los miniportes deben usar la estructura STOR_DEVICE_CAPABILITIES_EX para indicar la compatibilidad con funcionalidades adicionales.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows Vista.
Encabezado storport.h (incluya Storport.h, Minitape.h, Srb.h)

Consulte también

DEVICE_CAPABILITIES

SCSI_PNP_REQUEST_BLOCK

STOR_DEVICE_CAPABILITIES_EX