Función KsSetPowerDispatch (ks.h)

  • Artículo

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

Consulte también

KStrContextDispatch