PoFxSetComponentWake 함수(wdm.h)

  • 아티클

PoFxSetComponentWake 루틴은 구성 요소가 유휴 상태로 전환될 때마다 드라이버가 지정된 구성 요소를 절전 모드 해제할지 여부를 나타냅니다.

구문

void PoFxSetComponentWake(
  [in] POHANDLE Handle,
  [in] ULONG    Component,
  [in] BOOLEAN  WakeHint
);

매개 변수

[in] Handle

PoFx(전원 관리 프레임워크)를 사용하여 디바이스 등록을 나타내는 핸들입니다. 디바이스 드라이버는 이전에 PoFxRegisterDevice 루틴에서 이 핸들을 받았습니다.

[in] Component

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

[in] WakeHint

드라이버가 구성 요소가 유휴 상태에 들어갈 때마다 절전 모드를 해제하도록 구성 요소를 무기화할지 여부입니다. TRUE이면 드라이버가 구성 요소를 절전 모드 해제합니다. FALSE이면 드라이버가 구성 요소를 절전 모드 해제로 설정하지 않습니다.

반환 값

없음

설명

구성 요소가 저전력 Fx 상태로 진입하기 전에 드라이버는 외부 소스의 입력 신호에 대한 응답으로 구성 요소를 자동으로 절전 모드에서 해제할 수 있습니다(예: 사용자가 단추를 누르는 경우). WakeHint 매개 변수는 드라이버가 구성 요소를 절전 모드 해제할지 여부를 PoFx에 알릴 수 있습니다. 구성 요소가 절전 모드 해제되도록 무장된 경우 PoFx는 구성 요소를 절전 모드 해제할 수 없는 저전력 Fx 상태로 전환하지 않습니다.

디바이스가 PoFx에 등록되면 디바이스의 각 구성 요소에 대한 등록 정보가 별도의 PO_FX_COMPONENT 구조에 포함됩니다. 이 구조체의 DeepestWakeableIdleState 멤버는 구성 요소가 절전 모드를 해제할 수 있는 가장 깊은 Fx 상태를 지정합니다.

디바이스 드라이버는 조건 변경 시 WakeHint 값을 변경해야 할 때마다 PoFxSetComponentWake를 호출할 수 있습니다. 각 호출 후에는 드라이버가 PoFxSetComponentWake를 다시 호출하여 업데이트할 때까지 새 WakeHint 값이 계속 적용됩니다.

PoFxSetComponentWake가 호출될 때 구성 요소가 유휴 상태에 있는 경우 PoFx는 호출자가 지정한 새 WakeHint 매개 변수 값을 수용하도록 구성 요소의 Fx 상태를 변경할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 사용하여 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 wdm.h
라이브러리 Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

추가 정보

PO_FX_COMPONENT