Метод IWDFUsbTargetDevice::RetrievePowerPolicy (wudfusb.h)

  • Статья

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод RetrievePowerPolicy извлекает политику управления питанием WinUsb.

Синтаксис

HRESULT RetrievePowerPolicy(
  [in]      ULONG PolicyType,
  [in, out] ULONG *ValueLength,
  [out]     PVOID Value
);

Параметры

[in] PolicyType

Тип политики управления питанием WinUsb, запрашиваемой драйвером UMDF.

[in, out] ValueLength

Указатель на переменную, которая на входных данных содержит размер буфера, который RetrievePowerPolicy предоставляет в значении Value (в байтах). В выходных данных этот параметр содержит размер, необходимый для Параметра Value.

[out] Value

Указатель, получающий буфер, содержащий политику управления питанием WinUsb.

Возвращаемое значение

RetrievePowerPolicy возвращает одно из следующих значений:

Код возврата Описание
S_OK

RetrievePowerPolicy успешно извлекла политику управления питанием WinUsb.
E_OUTOFMEMORY

В RetrievePowerPolicy произошла ошибка выделения.
Код ошибки, определенный в Winerror.h
 Это значение соответствует коду ошибки, возвращенной API WinUsb.

Комментарии

Политика питания управляет управлением питанием, которое выполняет WinUsb для устройства.

Сведения о допустимых типах политик, которые драйвер UMDF может передать для параметра PolicyType и значений, возвращаемых платформой, см. в функции WinUsb_GetPowerPolicy .

Дополнительные сведения о поведении управления питанием WinUSB см. в разделе Управление питанием WinUSB.

Метод RetrievePowerPolicy создает запрос UMDF и синхронно отправляет запрос в целевой объект ввода-вывода.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.5
Верхняя часть wudfusb.h (включая Wudfusb.h)
DLL WUDFx.dll

См. также раздел

IWDFUsbTargetDevice

IWDFUsbTargetDevice::SetPowerPolicy

WinUsb_GetPowerPolicy