Função KsSetPowerDispatch (ks.h)
Define a função de expedição de energia a ser chamada quando o objeto de driver recebe um IRP IRP_MJ_POWER . Isso só será eficaz se KsDefaultDispatchPower for chamado para expedir ou concluir IRPs de energia.
Isso tem o efeito de adicionar esse cabeçalho de objeto a uma lista de cabeçalhos de objeto que têm rotinas de expedição de energia a serem executadas. O cabeçalho dessa lista é mantido pelo cabeçalho do dispositivo. Pressupõe que o chamador tenha alocado anteriormente um cabeçalho de dispositivo no objeto de dispositivo subjacente com KsAllocateDeviceHeader.
Sintaxe
KSDDKAPI VOID KsSetPowerDispatch(
[in] KSOBJECT_HEADER Header,
[in, optional] PFNKSCONTEXT_DISPATCH PowerDispatch,
[in, optional] PVOID PowerContext
);
Parâmetros
[in] Header
Aponta para um cabeçalho alocado anteriormente por KsAllocateObjectHeader.
[in, optional] PowerDispatch
Opcionalmente, contém a função de expedição de energia que será chamada ou NULL se a função for removida da lista de funções que estão sendo chamadas. Essa função não deve concluir o IRP de energia enviado. O valor retornado dessa função deve ser STATUS_SUCCESS. KsSetPowerDispatch poderá ser chamado durante a execução dessa rotina de expedição de energia se a finalidade for manipular somente essa entrada de lista. Manipular outras entradas de lista pode confundir a enumeração atual.
[in, optional] PowerContext
Opcionalmente, contém o parâmetro de contexto a ser passado para a função de expedição de energia.
Retornar valor
Nenhum
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |