Función WdfDeviceGetDevicePowerState (wdfdevice.h)

[Solo se aplica a KMDF]

Nota

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

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

Sintaxis

WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
  [in] WDFDEVICE Device
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

Valor devuelto

WdfDeviceGetDevicePowerState devuelve un enumerador con tipo WDF_DEVICE_POWER_STATE que identifica el estado actual de la máquina de estado 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, vea State Machines in the Framework.

El método WdfDeviceGetDevicePowerState devuelve un valor significativo solo si se llama desde dentro de las siguientes funciones de devolución de llamada:

• EvtDevicePrepareHardware

• EvtDeviceReleaseHardware

• EvtDeviceD0Entry

• EvtDeviceD0EntryPostInterruptsEnabled

• EvtDeviceD0Exit

• EvtDeviceD0ExitPreInterruptsDisabled

• EvtDeviceSelfManagedIoInit

• EvtDeviceSelfManagedIoSuspend

• EvtDeviceSelfManagedIoRestart

Ejemplos

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

WDF_DEVICE_POWER_STATE state;

state = WdfDeviceGetDevicePowerState(Device);

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdfdevice.h (incluir 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

WdfDeviceGetDevicePowerPolicyState