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


Функция WdfDeviceGetDevicePowerPolicyState (wdfdevice.h)

[Применимо только к KMDF]

Заметка

Эта функция предназначена только для внутреннего использования Майкрософт.

Метод WdfDeviceGetDevicePowerPolicyState возвращает текущее состояние компьютера состояния политики питания платформы для указанного устройства.

Синтаксис

WDF_DEVICE_POWER_POLICY_STATE WdfDeviceGetDevicePowerPolicyState(
  [in] WDFDEVICE Device
);

Параметры

[in] Device

Дескриптор объекта устройства платформы.

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

WdfDeviceGetDevicePowerPolicyState возвращает WDF_DEVICE_POWER_POLICY_STATEтипизированный перечислитель, определяющий текущее состояние компьютера состояния политики питания платформы для указанного устройства.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Дополнительные сведения о компьютерах с состоянием платформы см. в разделе "Компьютеры состояний" вПлатформы.

Метод WdfDeviceGetDevicePowerPolicyState возвращает понятное значение, только если он вызывается из функций обратного вызова, регистрируемых драйвером при вызове WdfDeviceInitSetPowerPolicyEventCallbacks.

Примеры

В следующем примере кода показано, как получить текущее состояние компьютера состояния политики питания платформы для указанного устройства.

WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;

devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(Device);

Требования

Требование Ценность
целевая платформа Всеобщий
минимальная версия KMDF 1.0
заголовка wdfdevice.h (include Wdf.h)
библиотеки Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL <= DISPATCH_LEVEL
правил соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerState