Función PcRequestNewPowerState (portcls.h)
La función PcRequestNewPowerState se usa para solicitar un nuevo estado de energía para el dispositivo. Normalmente, esta función no es necesaria para los controladores del adaptador, pero ocasionalmente puede ser útil para solucionar algunos tipos de problemas de hardware.
Sintaxis
PORTCLASSAPI NTSTATUS PcRequestNewPowerState(
[in] PDEVICE_OBJECT pDeviceObject,
[in] DEVICE_POWER_STATE RequestedNewState
);
Parámetros
[in] pDeviceObject
Puntero al objeto de dispositivo funcional (FDO) del adaptador. Este parámetro debe apuntar a una estructura del sistema de tipo DEVICE_OBJECT.
[in] RequestedNewState
Especifica el estado de alimentación del dispositivo que se solicita. Establezca este parámetro en uno de los siguientes valores de enumeración DEVICE_POWER_STATE: PowerDeviceD0, PowerDeviceD1, PowerDeviceD2 o PowerDeviceD3.
Valor devuelto
PcRequestNewPowerState devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un mensaje de error adecuado.
Comentarios
Un controlador de adaptador puede llamar a PcRequestNewPowerState para compensar los errores de diseño de hardware. Por ejemplo, si las funciones de un adaptador de audio no son mutuamente independientes y deben apagarse en un orden determinado, el adaptador puede llamar a PcRequestNewPowerState para asegurarse de que un subdevice determinado se apague primero.
El parámetro RequestedNewState se puede establecer en uno de los DEVICE_POWER_STATE valores de enumeración de la tabla siguiente.
| Estado de energía | Significado |
|---|---|
| PowerDeviceD0 | Estado de energía completo |
| PowerDeviceD1 | Estado de suspensión con la latencia de encendido más baja |
| PowerDeviceD2 | Un estado de suspensión de latencia media |
| PowerDeviceD3 | Un estado de hibernación completo y el estado de suspensión con la latencia de encendido más larga |
Solo se puede acceder al hardware en estado de energía PowerDeviceD0. En cualquier otro estado, el controlador debe almacenar en caché los accesos de hardware intentados y aplazar esos accesos hasta que se restaure el estado PowerDeviceD0 .
Para obtener más información, consulte Administración de energía para dispositivos de audio.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | El controlador del sistema PortCls implementa la función PcRequestNewPowerState en Microsoft Windows 98/Me y en los sistemas operativos Windows 2000 y versiones posteriores. |
| Plataforma de destino | Universal |
| Encabezado | portcls.h (incluir Portcls.h) |
| Library | Portcls.lib |
| IRQL | PASSIVE_LEVEL |