다음을 통해 공유

StorPortPoFxActivateComponent 함수(storport.h)

  • 아티클

StorPortPoFxActivateComponent 루틴은 스토리지 디바이스의 지정된 구성 요소에 대한 활성화 참조 수를 증가합니다.

구문

ULONG StorPortPoFxActivateComponent(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS       Address,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           ULONG               Component,
  [in]           ULONG               Flags
);

매개 변수

[in] HwDeviceExtension

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

[in, optional] Address

스토리지 디바이스 단위의 주소입니다. 스토리지 어댑터 구성 요소를 활성화할 때 이 매개 변수는 NULL 입니다.

[in, optional] Srb

구성 요소 활성화를 트리거하는 SRB입니다. 미니포트가 Storport를 통해 전송되지 않은 요청에 대한 디바이스 구성 요소를 활성화하는 경우 이 매개 변수는 NULL 입니다.

[in] Component

구성 요소를 식별하는 인덱스입니다. 이 매개 변수는 Miniport 드라이버가 StorPortInitializePoFxPower를 호출하여 디바이스에 등록한 STOR_POFX_DEVICE 구조의 Components 배열에 대한 인덱스입니다. Components 배열에 N 요소가 포함된 경우 구성 요소 인덱스는 0에서 N-1까지입니다.

[in] Flags

사용되지 않습니다. 0으로 설정합니다.

반환 값

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

반환 코드 설명
STOR_STATUS_SUCCESS
 스토리지 디바이스 활성화 참조가 성공적으로 증가했으며 구성 요소가 활성 상태입니다.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 또는 디바이스가 NULL입니다.

또는

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

또는

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

또는

스토리지 디바이스가 PoFx(전원 관리 프레임워크)에 등록되지 않았습니다.

또는

Srb가 가리키는 SRB는 Storport에서 전송되지 않습니다.

또는

Flags 매개 변수가 0이 아닌 경우
STOR_STATUS_INVALID_DEVICE_REQUEST
 어댑터 또는 장치는 PoFx를 지원하지 않습니다.
STOR_STATUS_INVALID_IRQL
 현재 IRQL > DISPATCH_LEVEL.
STOR_STATUS_BUSY
 스토리지 디바이스 활성화 참조가 성공적으로 증가했지만 구성 요소는 여전히 유휴 상태입니다.

설명

현재 어댑터 디바이스와 장치 디바이스의 최대 구성 요소 수는 1입니다. 구성 요소의 인덱스 는 항상 0으로 설정해야 합니다.

StorPortPoFxActivateComponent에 대한 각 호출은 StorPortPoFxIdleComponent에 대한 후속 호출과 일치해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 시작에서 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 storport.h
라이브러리 Storport.lib
IRQL IRQL <= DISPATCH_LEVEL

추가 정보

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent