EVT_ACX_FACTORY_CIRCUIT_POWER_UP función de devolución de llamada (acxcircuit.h)
El controlador usa la EVT_ACX_FACTORY_CIRCUIT_POWER_UP devolución de llamada para agregar funcionalidad en la ruta de acceso de encendido de un objeto ACXFACTORYCIRCUIT.
Sintaxis
EVT_ACX_FACTORY_CIRCUIT_POWER_UP EvtAcxFactoryCircuitPowerUp;
NTSTATUS EvtAcxFactoryCircuitPowerUp(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory,
WDF_POWER_DEVICE_STATE PreviousState
)
{...}
Parámetros
Device
Objeto WDFDEVICE (descrito en Resumen de objetos de marco) asociado al circuito ACX.
Factory
Objeto ACXFACTORYCIRCUIT de fábrica de circuitos existente. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.
PreviousState
WDF_POWER_DEVICE_STATE enumeración que identifica el estado de energía del dispositivo anterior.
Valor devuelto
Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Using NTSTATUS Values.
Si el controlador produce un error en esta devolución de llamada, etiqueta acXFACTORYCIRCUIT como eliminación pendiente. El marco ACX no produce un error en la devolución de llamada ACX EvtDeviceD0Entry, lo que permite que los ACXFACTORYCIRCUITs de trabajo existentes desde este dispositivo se usen para crear rutas de acceso de audio en funcionamiento.
Observaciones
Para registrar una función de devolución de llamada EvtFactoryCircuitPowerUp, un controlador debe llamar a AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks.
Si el controlador ha registrado una función de devolución de llamada EvtFactoryCircuitPowerUp para un dispositivo, el marco llama a la función cada vez que el dispositivo entra en su estado de trabajo (D0). Un dispositivo entrará en el estado D0 cuando se produzca una de las siguientes acciones:
- Se enumera un dispositivo (porque el dispositivo se ha conectado o se ha reiniciado el sistema).
- El sistema y todos sus dispositivos vuelven a sus estados de trabajo desde un estado de baja potencia.
- El dispositivo vuelve a su estado de trabajo después de que entró en un estado de baja potencia porque estaba inactivo (si el dispositivo admite inactividad de bajo consumo).
- El administrador de Plug and Play ha redistribuido los recursos de hardware del sistema entre los dispositivos del sistema.
- El marco llama a la función de devolución de llamada EvtDeviceD0Entry inmediatamente después de que el dispositivo entra en su estado de trabajo (D0) y está disponible para el controlador, pero antes de que se hayan habilitado las interrupciones del dispositivo. El parámetro PreviousState identifica el estado de alimentación del dispositivo en el que el dispositivo estaba antes de entrar en el estado D0. Cuando el marco llama primero a EvtDeviceD0Entry, proporciona un valor PreviousState de WdfPowerDeviceD3Final.
Esta función de devolución de llamada debe realizar las operaciones necesarias para que el dispositivo esté totalmente operativo.
Para obtener más información sobre los controladores que proporcionan esta función de devolución de llamada, consulte Compatibilidad con PnP y Administración de energía en Function Driver.
La función de devolución de llamada EvtFactoryCircuitPowerUp se llama en IRQL = PASSIVE_LEVEL. No debe hacer que esta función de devolución de llamada se pueda paginar.
Requisitos de ACX
versión mínima de ACX: 1.0
Para obtener más información sobre las versiones de ACX, consulte introducción a la versión de ACX.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | acxcircuit.h |
| irQL | PASSIVE_LEVEL |