Функция WdfDeviceGetDevicePowerState (wdfdevice.h)
[Применимо только к KMDF]
Заметка
Эта функция предназначена только для внутреннего использования Майкрософт.
Метод WdfDeviceGetDevicePowerState возвращает текущее состояние компьютера power machine платформы для указанного устройства.
Синтаксис
WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
[in] WDFDEVICE Device
);
Параметры
[in] Device
Дескриптор объекта устройства платформы.
Возвращаемое значение
WdfDeviceGetDevicePowerState возвращает WDF_DEVICE_POWER_STATE-типизированный перечислитель, определяющий текущее состояние компьютера состояния платформы для указанного устройства.
Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Замечания
Дополнительные сведения о компьютерах с состоянием платформы см. в разделе "Компьютеры состояний" вПлатформы.
Метод WdfDeviceGetDevicePowerState возвращает понятное значение, только если он вызывается из следующих функций обратного вызова:
Примеры
В следующем примере кода показано, как получить текущее состояние компьютера с питанием платформы для указанного устройства.
WDF_DEVICE_POWER_STATE state;
state = WdfDeviceGetDevicePowerState(Device);
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| минимальная версия KMDF | 1.0 |
| заголовка | wdfdevice.h (include Wdf.h) |
| библиотеки | Wdf01000.sys (см. управление версиями библиотеки Платформы).) |
| IRQL | <= DISPATCH_LEVEL |
| правил соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |