Método IPowerNotify::P owerChangeNotify (portcls.h)
El PowerChangeNotify método notifica al controlador de minipuerto los cambios en el estado de alimentación.
Sintaxis
void PowerChangeNotify(
[in] POWER_STATE PowerState
);
Parámetros
[in] PowerState
Especifica el estado de alimentación actual. Este parámetro es una unión de tipo POWER_STATE. Nuevo estado de energía (PowerState.DeviceState) puede ser uno de los valores de enumeración de DEVICE_POWER_STATE enumerados en IAdapterPowerManagement::P owerChangeState.
Valor devuelto
None
Observaciones
El controlador del sistema PortCls llama al método del PowerChangeNotify controlador de miniporte para notificarle los cambios en el estado de alimentación. El propósito de esta llamada es dar al controlador de minipuerto una oportunidad para guardar cualquier contexto específico del hardware justo antes de apagar o restaurar un contexto guardado anteriormente justo después de encenderse.
El controlador de minipuerto puede escribir en los registros de hardware o en la memoria a bordo durante la PowerChangeNotify llamada. Si el sistema se apaga (haciendo una transición de estado fuera de PowerDeviceD0), el controlador del sistema PortCls llama PowerChangeNotify antes de llamar a IAdapterPowerManagement::P owerChangeState y después de pausar cualquier flujo de datos de audio activo. Esto ofrece al controlador de miniporte la oportunidad de guardar cualquier contexto de dispositivo específico del hardware antes de que el dispositivo se apague. Por ejemplo, un controlador de miniport de WavePci podría necesitar guardar sus registros DMA si la apagado se produce durante una secuencia de transferencias de datos de dispersión o recopilación. Si el sistema está encendido (realizando una transición de estado hacia PowerDeviceD0), PortCls llama PowerChangeNotify después de llamar a PowerChangeState y antes de reiniciar cualquier secuencia de datos de audio en pausa. Esto ofrece al controlador de minipuerto una oportunidad para restaurar un contexto guardado anteriormente después de que el dispositivo se haya encendido.
El código de este método debe residir en memoria paginada.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | portcls.h (incluya Portcls.h) |