Интерфейс IPowerNotify (portcls.h)

  • Статья

Интерфейс IPowerNotify является необязательным интерфейсом, который могут предоставлять драйверы минипорта, если им требуется предварительное уведомление о предстоящем изменении состояния питания. Чтобы определить, поддерживает IPowerNotify ли драйвер мини-порта интерфейс, драйвер порта вызывает метод QueryInterface объекта miniport driver с IID_IPowerNotify REFIID. Следующие типы драйверов miniport могут поддерживать IPowerNotify:

IMiniportWavePci

IMiniportWaveCyclic

IMiniportMidi

IMiniportDMus

IMiniportTopology

IPowerNotify наследуется от интерфейса IUnknown .

Интерфейс IPowerNotify предоставляет единый метод, который вызывает драйвер порта для уведомления драйвера минипорта при изменении состояния питания.

Например, когда операционная система сообщает звуковому устройству волнового звука перейти в спящий режим, драйвер порта приостанавливает все активные потоки, а затем вызывает обратный вызов уведомления питания, чтобы сообщить драйверу минипорта о предстоящем отключении питания. Затем драйвер мини-порта может сохранить любой необходимый контекст перед вызовом метода PowerChangeState адаптера.

Процесс будет обратным при выключении устройства. PortCls сначала вызывает метод PowerChangeState адаптера, чтобы включить адаптер. Затем драйвер порта вызывает обратный вызов драйвера минипорта, чтобы позволить драйверу минипорта восстановить свой контекст. Наконец, драйвер порта отменяет приостановку ранее приостановленных активных аудиопотоков.

Дополнительные сведения см. в разделе Реализация IPowerNotify.

Наследование

Интерфейс IPowerNotify наследуется от интерфейса IUnknown . IPowerNotify также имеет следующие типы членов:

Методы

Интерфейс IPowerNotify содержит следующие методы.

 
IPowerNotify::P owerChangeNotify

Метод PowerChangeNotify уведомляет драйвер miniport об изменениях в состоянии питания.

Требования

Требование Значение
Целевая платформа Windows
Header portcls.h