PoFxSetComponentResidency 함수(wdm.h)

PoFxSetComponentResidency 루틴은 구성 요소가 유휴 상태로 전환된 후 구성 요소가 유휴 상태로 유지될 가능성이 있는 기간에 대한 예상 시간을 설정합니다.

구문

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

매개 변수

[in] Handle

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

[in] Component

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

[in] Residency

예상 상주 시간(100나노초 단위)입니다. 이 매개 변수는 활성 상태에서 유휴 상태로 전환한 후 구성 요소가 유휴 상태로 유지될 수 있는 기간에 대한 힌트입니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

없음

설명

호출 드라이버는 PoFx가 성능을 향상시키기 위해 힌트로 사용할 수 있는 예상 상주 시간을 제공합니다. PoFx는 이 힌트를 사용하여 유휴 상태에 있는 구성 요소에 적절한 저전력 Fx 상태를 선택합니다.

디바이스 드라이버는 상황의 변경으로 예상 보존 시간을 변경해야 할 때마다 PoFxSetComponentResidency 를 호출할 수 있습니다. 각 호출 후 드라이버가 PoFxSetComponentResidency 를 다시 호출하여 업데이트할 때까지 새로운 예상 상주 시간이 적용됩니다.

PoFxSetComponentResidency가 호출될 때 구성 요소가 유휴 상태에 있는 경우 PoFx는 호출자가 지정한 새로운 예상 상주 시간을 수용하도록 구성 요소의 Fx 상태를 변경할 수 있습니다.

요구 사항

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