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_STATEque 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.
Observaciones
Para obtener más información sobre las máquinas de estado del marco, consulte 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| biblioteca de | 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) |