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:
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) |