PO_FX_DIRECTED_POWER_DOWN_CALLBACK 콜백 함수(wdm.h)

PO_FX_DIRECTED_POWER_DOWN_CALLBACK 콜백 함수는 DFx(Directed PoFx)를 대신하여 드라이버별 전원 다운 작업을 처리하기 위해 클라이언트 드라이버에 의해 구현됩니다.

구문

PO_FX_DIRECTED_POWER_DOWN_CALLBACK PoFxDirectedPowerDownCallback;

void PoFxDirectedPowerDownCallback(
  PVOID Context,
  ULONG Flags
)
{...}

매개 변수

Context

PoFxRegisterDevice에 전달된 컨텍스트에 대한 포인터를 제공합니다.

Flags

다음에 사용하도록 예약됩니다.

반환 값

없음

설명

런타임 유휴 전원 관리 지원을 위해 PoFx에 등록하는 WDM 드라이버는 DFx 지원을 추가하려면 이 콜백을 구현해야 합니다.

PO_FX_DEVICE_V3 구조체의 적절한 멤버를 설정한 다음 PoFxRegisterDevice를 호출하여 이 콜백 함수의 구현을 등록합니다.

이 콜백은 이 디바이스 또는 이 디바이스의 종속성이 활성화자 조정 소프트웨어 작업이 실행되지 않고 최소 2분(드라이버 구성 가능한 시간 제한, 기본 2분)동안 DRIPS 항목을 차단한 경우 최신 대기 세션 중에 호출됩니다.

이 콜백이 호출되면 드라이버는 일반적으로 다음과 같은 상위 수준 작업을 수행합니다.

• 새 작업 처리를 중지합니다.

• 저전력 상태로 즉시 전환합니다.

• 시스템이 드라이버의 PO_FX_DIRECTED_POWER_UP_CALLBACK 호출할 때까지 저전력 상태로 유지합니다.

구현 단계 및 순서는 다를 수 있지만 다음 중 일부를 포함할 수 있습니다.

• Dx IRP를 요청합니다.

• Dx IRP가 도착한 후 I/O 큐를 차단합니다.

• 진행 중인 작업이 완료되기를 기다립니다.

• 이러한 작업이 너무 오래 걸리는 경우 필요에 따라 취소합니다.

• 디바이스를 Dx로 전환하는 데 필요한 작업을 수행합니다(예: 하드웨어 상태 저장).

• 필요에 따라 절 해제를 위한 팔.

• PoFxCompleteDirectedPowerDown을 호출합니다.

• 시스템이 PO_FX_DIRECTED_POWER_UP_CALLBACK 호출할 때까지 Dx에 남아 있습니다.

계약은 S3/S4와 매우 유사하지만 S-IRP는 관련되지 않습니다.

디바이스 계층이 관련된 경우 지시된 전원 프레임워크는 부모 디바이스 전에 자식 디바이스의 전원을 낮추도록 요청합니다. 지정된 부모 디바이스의 경우 전원 관계 로 인해 직접 자식(부모가 열거한 자식) 및 간접 자식이 고려됩니다.

요구 사항

참고 항목

지시된 전원 관리 프레임워크 소개

PO_FX_DIRECTED_POWER_UP_CALLBACK