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

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

[in] Flags

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

반환 값

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

반환 코드	묘사
STOR_STATUS_SUCCESS	스토리지 디바이스 활성화 참조가 성공적으로 증가했으며 구성 요소가 활성 상태입니다.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension 또는 디바이스 NULL입니다. -또는- 주소 잘못된 단위 주소 구조를 가리킵니다. -또는- Address 지정된 스토리지 디바이스를 찾을 수 없습니다. -또는- 스토리지 디바이스가 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