KsSetPowerDispatch 함수(ks.h)
드라이버 개체가 IRP_MJ_POWER IRP를 받을 때 호출할 전원 디스패치 함수를 설정합니다. 이는 KsDefaultDispatchPower 가 전원 IRP를 디스패치하거나 완료하기 위해 호출되는 경우에만 효과적입니다.
이는 실행할 전원 디스패치 루틴이 있는 개체 헤더 목록에 이 개체 헤더를 추가하는 효과가 있습니다. 이 목록의 헤드는 디바이스 헤더로 유지됩니다. 호출자가 이전에 KsAllocateDeviceHeader를 사용하여 기본 Device Object에 디바이스 헤더를 할당한 것으로 가정합니다.
구문
KSDDKAPI VOID KsSetPowerDispatch(
[in] KSOBJECT_HEADER Header,
[in, optional] PFNKSCONTEXT_DISPATCH PowerDispatch,
[in, optional] PVOID PowerContext
);
매개 변수
[in] Header
KsAllocateObjectHeader에서 이전에 할당한 헤더를 가리킵니다.
[in, optional] PowerDispatch
필요에 따라 호출될 전원 디스패치 함수를 포함하거나, 함수가 호출되는 함수 목록에서 제거될 경우 NULL 을 포함합니다. 이 함수는 IRP가 보낸 전원을 완료하면 안됩니다. 이 함수의 반환 값은 STATUS_SUCCESS 합니다. 이 목록 항목만 조작하려는 경우 이 전원 디스패치 루틴을 실행하는 동안 KsSetPowerDispatch를 호출할 수 있습니다. 다른 목록 항목을 조작하면 현재 열거형이 혼동 될 수 있습니다.
[in, optional] PowerContext
필요에 따라 전원 디스패치 함수에 전달할 컨텍스트 매개 변수를 포함합니다.
반환 값
없음
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |