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

Статья
02/29/2024

[Применяется только к 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)

См. также раздел

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerState