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

Статья
02/07/2025

[ предупреждение: 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 в значение. В выходных данных этот параметр содержит размер, который требуется RetrievePowerPolicy для значения.

[out] Value

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

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

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

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

Замечания

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

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

Дополнительные сведения о поведении power WinUSB см. в WinUSB Power Management.

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

Требования

Требование	Ценность
завершение поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа	Настольный
минимальная версия UMDF	1.5
заголовка	wudfusb.h (include Wudfusb.h)
DLL	WUDFx.dll

См. также

IWDFUsbTargetDevice

IWDFUsbTargetDevice::SetPowerPolicy

WinUsb_GetPowerPolicy

Поделиться через