Método IPowerNotify::P owerChangeNotify (portcls.h)
O método PowerChangeNotify notifica o driver de miniporto de alterações no estado de energia.
Sintaxe
void PowerChangeNotify(
[in] POWER_STATE PowerState
);
Parâmetros
[in] PowerState
Especifica o estado de energia atual. Esse parâmetro é uma união do tipo POWER_STATE. O novo estado de energia (PowerState.DeviceState) pode ser um dos valores de enumeração DEVICE_POWER_STATE listados em IAdapterPowerManagement::P owerChangeState.
Valor de retorno
Nenhum
Observações
O driver do sistema PortCls chama o método PowerChangeNotify do driver de miniporto para notificá-lo das alterações no estado de energia. A finalidade dessa chamada é dar ao driver de miniporto a oportunidade de salvar qualquer contexto específico de hardware pouco antes de desligar ou restaurar um contexto salvo anteriormente logo após a ativação.
O driver de miniporto pode gravar nos registros de hardware ou na memória a bordo durante a chamada PowerChangeNotify. Se o sistema estiver diminuindo (fazendo uma transição de estado para longe do PowerDeviceD0), o driver do sistema PortCls chamará PowerChangeNotify antes de chamar IAdapterPowerManagement::P owerChangeState e depois de pausar os fluxos de dados de áudio ativos. Isso dá ao driver de miniporto a oportunidade de salvar qualquer contexto de dispositivo específico de hardware antes que o dispositivo seja desligado. Por exemplo, um driver de miniporto WavePci pode precisar salvar seus registros de DMA se a queda de energia ocorrer durante uma sequência de transferências de dados de dispersão/coleta. Se o sistema estiver habilitando (fazendo uma transição de estado para o PowerDeviceD0), o PortCls chamará PowerChangeNotify depois de chamar PowerChangeState e antes de reiniciar os fluxos de dados de áudio pausados. Isso dá ao driver de miniporto a oportunidade de restaurar um contexto salvo anteriormente depois que o dispositivo for habilitado.
O código para esse método deve residir na memória paginada.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | portcls.h (inclua Portcls.h) |