estructura STOR_DEVICE_CAPABILITIES (srb.h)

La estructura STOR_DEVICE_CAPABILITIES notifica las funcionalidades del dispositivo al controlador de puerto SCSI 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. Establézcalo en STOR_DEVICE_CAPABILITIES_EX_VERSION_1 por puerto SCSI.

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 ejección de dispositivos controladas 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.
• El dispositivo se muestra en el programa Unplug o Eject 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 minipuerto del dispositivo puede controlar el caso en el que se quita el dispositivo antes de que el puerto SCSI pueda enviar SRB_FUNCTION_PNP con StorRemoveDevice como PnPAction en la estructura 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 una 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.

El puerto SCSI envía esta estructura al miniporte con todos los miembros inicializados en 0.

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	srb.h (incluya Storport.h, Minitape.h, Srb.h)

Consulte también

DEVICE_CAPABILITIES

SCSI_PNP_REQUEST_BLOCK

STOR_DEVICE_CAPABILITIES_EX