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

Confira também

KStrContextDispatch