Función WdfDeviceGetDevicePowerPolicyState (wdfdevice.h)

[Solo se aplica a KMDF]

Nota

Esta función es solo para uso interno de Microsoft.

El método WdfDeviceGetDevicePowerPolicyState devuelve el estado actual de la máquina de estado de la directiva de energía del marco para un dispositivo especificado.

Sintaxis

WDF_DEVICE_POWER_POLICY_STATE WdfDeviceGetDevicePowerPolicyState(
  [in] WDFDEVICE Device
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

Valor devuelto

WdfDeviceGetDevicePowerPolicyState devuelve un enumerador con tipo WDF_DEVICE_POWER_POLICY_STATE que identifica el estado actual de la máquina de estado de la directiva de energía del marco para el dispositivo especificado.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

Para obtener más información sobre las máquinas de estado del marco, consulte State Machines in the Framework.

El método WdfDeviceGetDevicePowerPolicyState devuelve un valor significativo solo si se llama desde dentro de las funciones de devolución de llamada que el controlador registra cuando llama a WdfDeviceInitSetPowerPolicyEventCallbacks.

Ejemplos

En el ejemplo de código siguiente se obtiene el estado actual de la máquina de estado de la directiva de energía del marco para un dispositivo especificado.

WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;

devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(Device);

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdevice.h (incluya Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerState