Функция 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 (включая Wdf.h) |
| Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки платформы). |
| IRQL | <= DISPATCH_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |