Função KsSetPowerDispatch (ks.h)
Define a função de expedição de energia a ser chamada quando o objeto driver recebe um IRP IRP_MJ_POWER. Isso só será eficaz se KsDefaultDispatchPower for chamado para expedir ou concluir a energia dos IRPs.
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 deve ser 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 pode 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.
Valor de retorno
Nenhum
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |