Функция KsFilterRegisterPowerCallbacks (ks.h)
Функция KsFilterRegisterPowerCallbacks регистрирует обратные вызовы управления питанием для Filter.
Синтаксис
void KsFilterRegisterPowerCallbacks(
[in] PKSFILTER Filter,
[in, optional] PFNKSFILTERPOWER Sleep,
[in, optional] PFNKSFILTERPOWER Wake
);
Параметры
[in] Filter
Указатель на структуру KSFILTER , для которой регистрируются обратные вызовы питания. Чтобы получать уведомления о энергопотреблении, фильтр должен быть ориентирован на фильтрацию.
[in, optional] Sleep
Указатель на функцию, которая обрабатывает запросы спящего режима для устройства. Если значение РАВНО NULL, обратный вызов спящего режима не регистрируется. Дополнительные сведения см. в разделе Примечания ниже.
[in, optional] Wake
Указатель на функцию, которая обрабатывает запросы пробуждения для устройства. Если значение РАВНО NULL, обратный вызов пробуждения не указан. Дополнительные сведения см. в разделе Примечания ниже.
Возвращаемое значение
None
Remarks
Предупреждение
Не пытайтесь получить мьютекс элемента управления фильтром* из обратного вызова спящего режима или пробуждения, иначе может возникнуть взаимоблокировка. Дополнительные сведения о мьютексах см. в статье Мьютексы в AVStream.
Два обратных вызова должны быть прототипами следующим образом:
void Sleep/Wake (IN PKSFILTER Filter, IN DEVICE_POWER_STATE State);
Обратный вызов спящего режима выполняется, если Фильтр является фильтром, ориентированным на фильтры, и устройство переходит в спящий режим. Обратный вызов пробуждения выполняется, если Фильтр является фильтром, ориентированным на фильтры, и устройство просыпается.
Сведения о состояниях питания устройства см. в разделе Состояния питания устройства.
См. также статьи Инициализация avStream Minidriver и Обработка, ориентированная на фильтрацию.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях. |
Целевая платформа | Универсальное |
Верхняя часть | ks.h (включая Ks.h) |
Библиотека | Ks.lib |
IRQL | PASSIVE_LEVEL |