Función KsSetPowerDispatch (ks.h)
Establece la función de distribución de energía a la que se llamará cuando el objeto del controlador recibe un IRP_MJ_POWER IRP. Esto solo es eficaz si se llama a KsDefaultDispatchPower para enviar o completar IRP de energía.
Esto tiene el efecto de agregar este encabezado de objeto a una lista de encabezados de objeto que tienen rutinas de distribución de energía para ejecutar. El encabezado del dispositivo mantiene el encabezado del encabezado del dispositivo. Supone que el autor de la llamada ha asignado previamente un encabezado de dispositivo en el objeto device subyacente con KsAllocateDeviceHeader.
Sintaxis
KSDDKAPI VOID KsSetPowerDispatch(
[in] KSOBJECT_HEADER Header,
[in, optional] PFNKSCONTEXT_DISPATCH PowerDispatch,
[in, optional] PVOID PowerContext
);
Parámetros
[in] Header
Apunta a un encabezado asignado previamente por KsAllocateObjectHeader.
[in, optional] PowerDispatch
Opcionalmente, contiene la función de distribución de energía a la que se llamará o NULL si se va a quitar la función de la lista de funciones a las que se llama. Esta función no debe completar el IRP de energía enviado. El valor devuelto de esta función debe ser STATUS_SUCCESS. Se puede llamar a KsSetPowerDispatch mientras se ejecuta esta rutina de distribución de energía si el propósito es manipular esta entrada de lista solo. Manipular otras entradas de lista puede confundir la enumeración actual.
[in, optional] PowerContext
Opcionalmente, contiene el parámetro de contexto que se va a pasar a la función de distribución de energía.
Valor devuelto
None
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluya Ks.h) |
| Library | Ks.lib |