다음을 통해 공유


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

구성 요소 배열의 요소 수입니다. 이 멤버를 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