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 구조의 구성 요소 배열에 대한 인덱스입니다. 구성 요소 배열에 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이면 드라이버는 하드웨어의 성능 상태를 변경하는 데 필요한 모든 작업을 수행해야 합니다. 성공 경우 드라이버는 아무 작업도 수행하지 않거나 동일한 성능 상태 또는 대체 성능 상태로 요청을 다시 시도하도록 선택할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10부터 지원됩니다. |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | wdm.h |
| IRQL | IRQL <= DISPATCH_LEVEL 호출합니다. |
참고 항목
PoFxIssueComponentPerfStateChange