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

Consulte también

DEVICE_OBJECT