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

추가 정보

KStrContextDispatch