PO_FX_COMPONENT_PERF_STATE_CALLBACK 콜백 함수(wdm.h)

ComponentPerfStateCallback 콜백 루틴은 드라이버에 구성 요소의 성능 상태 변경 요청이 완료되었다는 것을 알 수 있습니다.

구문

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

void PoFxComponentPerfStateCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Succeeded,
  [in] PVOID RequestContext
)
{...}

매개 변수

[in] Context

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

[in] Component

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

[in] Succeeded

TRUE이면 PEP(플랫폼 확장 플러그 인)가 성능 상태 변경에 성공했습니다. FALSE이면 PEP가 성능 상태 변경에 실패했습니다. 자세한 내용은 주의 섹션을 참조하세요.

[in] RequestContext

PoFxIssueComponentPerfStateChange 또는 PoFxIssueComponentPerfStateChangeMultiple 루틴의 Context 매개 변수로 지정된 선택적 드라이버 또는 디바이스 컨텍스트에 대한 포인터입니다.

반환 값

없음

설명

디바이스 드라이버가 PoFxIssueComponentPerfStateChange 또는 PoFxIssueComponentPerfStateChangeMultiple 루틴을 호출하여 성능 상태 변경을 요청하는 경우 PoFx는 ComponentPerfStateCallback 루틴을 호출하여 요청이 완료되면 드라이버에 알립니다.

ComponentPerfStateCallback 루틴을 지정하려면 드라이버가 PoFx에서 성능 상태 관리를 위해 등록할 때 PoFxRegisterComponentPerfStates 루틴의 ComponentPerfStateCallback 매개 변수를 사용합니다. ComponentPerfStateCallback 루틴은 모든 구성 요소 및 모든 디바이스에서 동일할 수 있습니다.

Succeeded가 TRUE이면 드라이버는 하드웨어의 성능 상태를 변경하는 데 필요한 모든 작업을 수행해야 합니다. Succeeded가 FALSE이면 드라이버는 아무 작업도 수행하지 않거나 동일한 성능 상태 또는 대체 성능 상태로 요청을 다시 시도할 수 있습니다.

요구 사항

추가 정보

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice