Método IPowerNotify::P owerChangeNotify (portcls.h)

O PowerChangeNotify método 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.

Retornar valor

Nenhum

Comentários

O driver do sistema PortCls chama o método do driver de PowerChangeNotify miniport para notificá-lo sobre as 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 habilitação.

O driver de miniporte pode gravar nos registros de hardware ou na memória a bordo durante a PowerChangeNotify chamada. Se o sistema estiver desligando (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 desligue. Por exemplo, um driver de miniporto WavePci pode precisar salvar seus registros de DMA se a desligar 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 PowerDeviceD0), 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
Plataforma de Destino	Universal
Cabeçalho	portcls.h (inclua Portcls.h)

Confira também

IAdapterPowerManagement::P owerChangeState

IPowerNotify