Метод IWDFUsbTargetDevice::SetPowerPolicy (wudfusb.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]
Метод SetPowerPolicy задает политику управления питанием WinUsb.
Синтаксис
HRESULT SetPowerPolicy(
[in] ULONG PolicyType,
[in] ULONG ValueLength,
[in] PVOID Value
);
Параметры
[in] PolicyType
Тип политики управления питанием WinUsb, задаваемой драйвером UMDF.
[in] ValueLength
Размер (в байтах) буфера, который SetPowerPolicy предоставляет в параметре Value.
[in] Value
Указатель на буфер, содержащий политику управления питанием WinUsb.
Возвращаемое значение
SetPowerPolicy возвращает одно из следующих значений:
| Код возврата | Описание |
|---|---|
|
SetPowerPolicy успешно настроит политику управления питанием WinUsb. |
|
В SetPowerPolicy обнаружен сбой выделения ресурсов. |
|
Это значение соответствует коду ошибки, возвращенной API WinUsb. |
Комментарии
Политика питания управляет управлением питанием, которое выполняет WinUsb для устройства.
Сведения о допустимых типах политик и значениях, которые драйвер UMDF может передать для параметров PolicyType и Value , см. в функции WinUsb_SetPowerPolicy .
Дополнительные сведения о поведении управления питанием WinUSB см. в разделе Управление питанием WinUSB.
Метод SetPowerPolicy создает запрос UMDF и синхронно отправляет его в целевой объект ввода-вывода.
Требования
| Требование | Значение |
|---|---|
| Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Минимальная версия UMDF | 1.5 |
| Верхняя часть | wudfusb.h (включая Wudfusb.h) |
| DLL | WUDFx.dll |