KsSetPowerDispatch 함수(ks.h)

드라이버 개체가 IRP_MJ_POWER IRP를 받을 때 호출할 전원 디스패치 함수를 설정합니다. 이는 KsDefaultDispatchPower 호출되어 전원 IRP를 디스패치하거나 완료하는 경우에만 효과적입니다.

이 경우 실행할 전원 디스패치 루틴이 있는 개체 헤더 목록에 이 개체 헤더를 추가하는 효과가 있습니다. 이 목록의 헤드는 디바이스 헤더에 의해 유지됩니다. 호출자가 이전에 KsAllocateDeviceHeader사용하여 기본 디바이스 개체에 디바이스 헤더를 할당한 것으로 가정합니다.

통사론

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

참고 항목

KStrContextDispatch