STOR_DEVICE_CAPABILITIES 구조체(storport.h)

아티클
02/07/2025

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 설정된 경우 SurpriseRemovalOKTRUE설정하지 않는 한 디바이스가 하드웨어 제거 또는 분리 프로그램에 표시됩니다.

DockDevice

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

UniqueID

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

SilentInstall

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

SurpriseRemovalOK

Storport가 SCSI_PNP_REQUEST_BLOCK 구조에서 PnPActionStorRemoveDevice 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 구조를 사용해야 합니다.