STOR_DEVICE_CAPABILITIES 구조체(storport.h)

아티클
02/27/2024

STOR_DEVICE_CAPABILITIES 구조는 SRB_FUNCTION_PNP 함수를 사용하여 SRB(SCSI 요청 블록)의 기능 쿼리에 대한 응답으로 Storport 드라이버에 디바이스 기능을 보고합니다. STOR_DEVICE_CAPABILITIES 스토리지 디바이스와 관련된 멤버를 포함하는 DEVICE_CAPABILITIES 구조의 하위 집합입니다.

구문

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;

멤버

Version

구조체의 버전을 지정합니다. Storport에서 STOR_DEVICE_CAPABILITIES_EX_VERSION_1 로 설정합니다.

DeviceD1

디바이스 하드웨어가 D1 전원 상태를 지원하는지 여부를 지정합니다. 미니포트 드라이버는 이 비트를 0으로 설정합니다.

DeviceD2

디바이스 하드웨어가 D2 전원 상태를 지원하는지 여부를 지정합니다. 미니포트 드라이버는 이 비트를 0으로 설정합니다.

LockSupported

디바이스가 디바이스 배출을 방지하는 물리적 디바이스 잠금을 지원하는지 여부를 지정합니다. 이 멤버는 LUN 또는 단위 디바이스를 꺼내는 작업과 관련이 있습니다.

EjectSupported

시스템이 PowerSystemWorking 상태인 동안 디바이스가 소프트웨어 제어 디바이스 배출을 지원하는지 여부를 지정합니다. 이 멤버는 LUN 또는 단위 디바이스를 꺼내는 작업과 관련이 있습니다.

Removable

직접 부모에서 디바이스를 동적으로 제거할 수 있는지 여부를 지정합니다. 이동식이 TRUE로 설정된 경우 디바이스는 부모와 동일한 물리적 개체에 속하지 않습니다.

이동식이 TRUE로 설정된 경우 SurpriseRemovalOK도 TRUE로 설정되지 않는 한 디바이스가 플러그 뽑기 또는 하드웨어 꺼내기 프로그램에 표시됩니다.

DockDevice

디바이스가 도킹 주변 장치인지 여부를 지정합니다.

UniqueID

디바이스의 instance ID가 시스템 전체에서 고유한지 여부를 지정합니다. 이 비트는 instance ID가 버스의 scope 내에서만 고유한지 분명합니다.

SilentInstall

장치 관리자 모든 설치 대화 상자를 표시하지 않아야 하는지 여부를 지정합니다. "호환되는 드라이버를 찾을 수 없음"과 같은 필수 대화 상자를 제외하고.

SurpriseRemovalOK

Storport가 storremoveDevice를 SCSI_PNP_REQUEST_BLOCK 구조의PnPAction으로 SRB_FUNCTION_PNP 보내기 전에 디바이스의 미니포트 드라이버가 디바이스가 제거된 경우를 처리할 수 있는지 여부를 지정합니다. SurpriseRemovalOK가 TRUE로 설정된 경우 드라이버가 있는 상태에 관계없이 디바이스를 즉시 부모에서 안전하게 제거할 수 있습니다.

NoDisplayInUI

사용자 인터페이스에 디바이스를 표시하지 마세요. 이 비트가 설정되면 디바이스가 있지만 시작에 실패한 경우에도 디바이스가 사용자 인터페이스에 표시되지 않습니다. 미니포트 드라이버는 이 비트를 설정하지 않습니다.

설명

미니포트 드라이버가 SRB 함수가 SRB_FUNCTION_PNP HwStorStartIo 루틴에서 SRB를 받으면 SRB는 SCSI_PNP_REQUEST_BLOCK 구조체로 형식이 지정됩니다. SRB의 PnPAction 멤버가 StorQueryCapabilities인 경우 미니포트는 SRB의 DataBuffer 멤버에 STOR_DEVICE_CAPABILITIES 구조를 반환할 수 있습니다.

Storport는 모든 멤버가 0으로 초기화된 상태에서 이 구조를 미니포트로 보냅니다. 반환할 때 이 구조체에서 이동식 필드만 사용됩니다.

Windows 8 미니포트는 STOR_DEVICE_CAPABILITIES_EX 구조를 사용하여 추가 기능에 대한 지원을 나타내야 합니다.