PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK 콜백 함수(wdm.h)

  • 아티클

ComponentCriticalTransitionCallback 콜백 루틴은 F0(완전 켜기)과 저전력 Fx 구성 요소 전원 상태 간에 지정된 구성 요소의 전환을 처리합니다.

구문

PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;

void PoFxComponentCriticalTransitionCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Active
)
{...}

매개 변수

[in] Context

디바이스 컨텍스트에 대한 포인터입니다. 디바이스 드라이버는 이 컨텍스트를 사용하여 디바이스의 현재 전원 상태에 대한 정보를 저장합니다. 이 컨텍스트는 드라이버 정의이며 PoFx에 불투명합니다. 드라이버는 드라이버가 디바이스를 PoFx(Windows 전원 관리 프레임워크)에 등록하는 데 사용한 PO_FX_CORE_DEVICE 구조의 DeviceContext 멤버에 이 포인터를 지정했습니다.

[in] Component

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

[in] Active

이 알림이 F0 구성 요소 전원 상태로 전환하기 위한 것인지 여부를 나타냅니다. TRUE이면 구성 요소가 저전력 Fx 상태에서 F0으로의 전환을 완료했습니다. FALSE이면 구성 요소가 F0에서 저전력 Fx 상태로 전환을 시작하려고 합니다.

반환 값

없음

설명

이 콜백 루틴은 디바이스 드라이버에 의해 구현되며 PoFx에서 호출됩니다. PoFx는 이 루틴을 호출하여 드라이버에 디바이스 구성 요소의 전원 전환을 알립니다.

PO_FX_CORE_DEVICE 구조체의 ComponentCriticalTransitionCallback 멤버는 ComponentCriticalTransitionCallback 콜백 루틴에 대한 포인터입니다. PO_FX_CORE_DEVICE 구조체에 대한 포인터는 핵심 디바이스를 PoFx(Windows 전원 관리 프레임워크)에 등록하는 PoFxRegisterCoreDevice 호출에서 입력 매개 변수로 전달됩니다.

이 루틴에 대한 호출을 처리하기 위해 디바이스 드라이버는 디바이스에서 지정된 구성 요소의 레지스터 상태 또는 기타 하드웨어 컨텍스트를 저장하거나 복원합니다.

Active = TRUE인 경우 구성 요소가 저전력 Fx 상태에서 F0으로의 전환을 완료한 후 PoFx에서 이 루틴을 호출했습니다. 이 호출에서 루틴은 구성 요소의 이전에 저장된 하드웨어 컨텍스트를 복원합니다.

Active = FALSE인 경우 구성 요소가 F0에서 저전력 Fx 상태로의 보류 중인 전환을 시작하기 전에 PoFx에서 이 루틴을 호출했습니다. 이 호출에서 루틴은 나중에 이 컨텍스트를 복원할 수 있도록 구성 요소의 하드웨어 컨텍스트를 저장합니다.

Fx 구성 요소 전원 상태에 대한 자세한 내용은 구성 요소 수준 전원 관리를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 부터 지원합니다.
대상 플랫폼 Windows
헤더 wdm.h(Wudfwdm.h 포함)

추가 정보

PO_FX_CORE_DEVICE