StorPortInitializePoFxPower 함수(storport.h)

미니포트 드라이버는 StorPortInitializePoFxPower 를 호출하여 PoFx(전원 관리 프레임워크)에 스토리지 디바이스를 등록합니다.

구문

ULONG StorPortInitializePoFxPower(
  [in]           PVOID             HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS     Address,
  [in]           PSTOR_POFX_DEVICE Device,
  [in, out]      PBOOLEAN          D3ColdEnabled
);

매개 변수

[in] HwDeviceExtension

HBA(호스트 버스 어댑터)의 하드웨어 디바이스 확장에 대한 포인터입니다.

[in, optional] Address

스토리지 디바이스 단위의 주소입니다. 이 매개 변수는 스토리지 어댑터에 등록할 때 NULL 입니다.

[in] Device

STOR_POFX_DEVICE_V2 구조체에 대한 포인터가 STOR_POFX_DEVICE 포인터로 캐스팅되었습니다. 이 구조에는 스토리지 디바이스에 대한 F-상태가 있는 구성 요소 목록이 포함되어 있습니다.

[in, out] D3ColdEnabled

Storport 드라이버가 스토리지 디바이스에 대해 D3 콜드 상태를 사용할 수 있는지 여부를 나타내도록 설정하는 BOOLEAN 값에 대한 포인터입니다.

반환 값

StorPortInitializePoFxPower 루틴은 다음 상태 코드 중 하나를 반환합니다.

반환 코드 설명
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtension 또는 디바이스가 NULL입니다.

또는

주소 는 잘못된 단위 주소 구조를 가리킵니다.

또는

주소로 지정된 스토리지 디바이스를 찾을 수 없습니다.

또는

디바이스에서 가리키는 STOR_POFX_DEVICE 구조체의 형식이 잘못되었거나 잘못된 데이터가 포함되어 있습니다.

STOR_STATUS_SUCCESS
스토리지 디바이스가 PoFx에 성공적으로 등록되었습니다.
STOR_STATUS_INSUFFICIENT_RESOURCES
PoFx에 스토리지 디바이스를 등록하는 데 충분한 리소스를 사용할 수 없습니다.
STOR_STATUS_UNSUCCESSFUL
스토리지 디바이스가 PoFx에 성공적으로 등록되지 않았습니다.

또는

스토리지 디바이스가 이미 PoFx에 등록되어 있습니다.

설명

어댑터 디바이스는 항상 주소대한 NULL 값으로 등록됩니다. 단위 디바이스는 주소에 유효한 단위 주소를 지정하여 등록됩니다.

STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD 플래그가 디바이스의 Flags 멤버에 설정된 경우 Storport는 디바이스 구성 요소에 대해 D3 콜드 지원을 사용하도록 설정하려고 시도합니다. D3 Cold 지원 상태 D3ColdEnabled가 가리키는 BOOLEAN 값으로 반환됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8 시작해서 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 storport.h

추가 정보

STOR_POFX_DEVICE