Функция DevicePowerEnumDevices (powrprof.h)
Перечисляет устройства в системе, которые соответствуют заданным критериям.
Синтаксис
BOOLEAN DevicePowerEnumDevices(
[in] ULONG QueryIndex,
[in] ULONG QueryInterpretationFlags,
[in] ULONG QueryFlags,
[out, optional] PBYTE pReturnBuffer,
[in, out] PULONG pBufferSize
);
Параметры
[in] QueryIndex
Индекс запрошенного устройства. Для начальных вызовов это значение должно быть равно нулю.
[in] QueryInterpretationFlags
Критерии, применяемые к результатам поиска.
[in] QueryFlags
Критерии запроса.
[out, optional] pReturnBuffer
Указатель на буфер, который получает запрошенные сведения.
[in, out] pBufferSize
Размер возвращаемого буфера (в байтах).
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение.
Комментарии
Значения параметра QueryFlags можно объединить для запроса устройств, поддерживающих два или более критерия. Например; Если PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED передается в качестве параметра QueryFlags , функция будет запрашивать устройства, поддерживающие D3 или D1.
QueryFlags также можно объединить с Параметром QueryInterpretationFlags , для DEVICEPOWER_AND_OPERATION для создания запроса устройств, поддерживающих все запрошенные условия. Например; Если PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED передается в качестве параметра QueryFlags , а DEVICEPOWER_AND_OPERATION передается в качестве параметра QueryInterpretationFlags , функция будет запрашивать устройства, поддерживающие как D3, так и D1.
Примеры
Пример использования этой функции см. в разделе Использование API power для устройств.
Требования
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | powrprof.h |
Библиотека | PowrProf.lib |
DLL | PowrProf.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по