STOR_POFX_DEVICE 구조체(storport.h)

STOR_POFX_DEVICE 구조는 PoFx(전원 관리 프레임워크)에 대한 스토리지 디바이스의 전원 특성을 설명합니다.

구문

typedef struct _STOR_POFX_DEVICE {
  ULONG               Version;
  ULONG               Size;
  ULONG               ComponentCount;
  ULONG               Flags;
  STOR_POFX_COMPONENT Components[ANYSIZE_ARRAY];
} STOR_POFX_DEVICE, *PSTOR_POFX_DEVICE;

멤버

Version

이 구조체의 버전 번호입니다. 이 멤버를 STOR_POFX_DEVICE_VERSION_V1 설정합니다.

Size

이 구조체의 크기입니다. 이 값을 STOR_POFX_DEVICE_SIZE 설정합니다.

ComponentCount

Components 배열의 요소 수입니다 . 이 멤버를 1로 설정합니다. 현재 스토리지 어댑터 또는 논리 단위에 대해 단일 구성 요소만 지원됩니다.

Flags

디바이스 전원 상태 기능 플래그입니다. 미니포트는 하나 이상의 PoFx 디바이스 플래그를 설정하여 전원 상태 기능을 사용하거나 사용하지 않도록 설정합니다.

플래그 는 다음의 비트 OR 조합입니다.

의미
STOR_POFX_DEVICE_FLAG_DISABLE_INTERRUPTS_ON_D3
설정되면 Storport가 어댑터를 D3에 배치할 때 인터럽트 사용 안 함을 지정하고 D0으로 다시 시작될 때 인터럽트는 다시 활성화됩니다.
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD
Storport가 어댑터를 지원하는 경우 어댑터의 D3 콜드 상태를 설정할 수 있습니다. 이 플래그는 어댑터에만 적용됩니다.
STOR_POFX_DEVICE_FLAG_NO_D0
어댑터 또는 장치의 디바이스 개체에 전원을 공급할 IRP를 보내지 않도록 요청합니다.
STOR_POFX_DEVICE_FLAG_NO_D3
전원이 켜진 IRP를 어댑터 또는 장치의 디바이스 개체로 보내지 않도록 요청합니다.
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE
디바이스가 유휴 상태로 전환되었거나 유휴 상태일 때 전원이 꺼진 경우 미니포트는 덤프 모드에서 스토리지 디바이스를 활성 상태로 전환할 수 없습니다. 이 플래그는 디바이스가 유휴 상태일 때 덤프에 사용할 수 있는지 여부를 나타냅니다.

Components[ANYSIZE_ARRAY]

이 멤버는 하나 이상의 STOR_POFX_COMPONENT 요소 배열에서 첫 번째 요소입니다. 배열에 둘 이상의 요소가 포함된 경우 추가 요소는 즉시 STOR_POFX_DEVICE 구조체를 따릅니다. 배열에는 디바이스의 각 구성 요소에 대해 하나의 요소가 포함됩니다. 현재 스토리지 디바이스에는 하나의 구성 요소만 있으므로 추가 구성 요소 구조가 필요하지 않습니다.

설명

Storport PoFx 지원을 위한 스토리지 어댑터를 등록하기 위해 미니포트 드라이버는 HwStorInitialize 루틴에서 StorPortEnablePassiveInitialization을 호출하고 HwStorPassiveInitializeRoutine을 구현합니다. 미니포트는 HwStorPassiveInitializeRoutine 내에서 StorPortInitializePoFxPower를 호출하여 어댑터 구성 요소에 대한 정보를 제공합니다.

Storport PoFx 지원을 위한 스토리지 단위를 등록하기 위해 미니포트 드라이버는 HwStorUnitControl 콜백 루틴을 구현하고 ScsiUnitPoFxPowerInfo 단위 제어 코드를 처리합니다. ScsiUnitPoFxPowerInfo 제어 코드를 처리하는 경우 미니포트는 단위 구성 요소에 대한 유휴 전원 관리를 사용하도록 설정된 경우 StorPortInitializePoFxPower를 호출합니다.

구성 요소 배열 인덱스로 식별되는 스토리지 디바이스 의 구성 요소입니다 . 스토리지 디바이스에는 하나의 구성 요소만 있으므로 인덱스 0이 사용됩니다. StorPortPoFxActivateComponentStorPortPoFxIdleComponent와 같은 루틴은 구성 요소의 배열 인덱스를 사용하여 구성 요소를 식별합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8 부터 지원합니다.
머리글 storport.h

추가 정보

STOR_POFX_COMPONENT

StorPortInitializePoFxPower

StorPortPoFxActivateComponent

StorPortPoFxIdleComponent