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_STATEque 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.
Observaciones
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 | 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) |