Edit

USB_POWER_INFO structure (usbuser.h)

  • Article

The USB_POWER_INFO structure is used with the IOCTL_USB_USER_REQUEST I/O control request to retrieve device power state that the host controller power policy specifies for the indicated system power state.

Syntax

typedef struct _USB_POWER_INFO {
  WDMUSB_POWER_STATE SystemState;
  WDMUSB_POWER_STATE HcDevicePowerState;
  WDMUSB_POWER_STATE HcDeviceWake;
  WDMUSB_POWER_STATE HcSystemWake;
  WDMUSB_POWER_STATE RhDevicePowerState;
  WDMUSB_POWER_STATE RhDeviceWake;
  WDMUSB_POWER_STATE RhSystemWake;
  WDMUSB_POWER_STATE LastSystemSleepState;
  BOOLEAN            CanWakeup;
  BOOLEAN            IsPowered;
} USB_POWER_INFO, *PUSB_POWER_INFO;

Members

SystemState

On input, a WDMUSB_POWER_STATE-type enumerator value that specifies the system power state.

HcDevicePowerState

On output, an WDMUSB_POWER_STATE-type enumerator value that specifies the device power state of the host controller.

HcDeviceWake

On output, a WDMUSB_POWER_STATE-type enumerator value that specifies whether the host controller is in a wake state.

HcSystemWake

On output, a WDMUSB_POWER_STATE-type enumerator value that specifies whether the host controller can wake the system.

RhDevicePowerState

On output, a WDMUSB_POWER_STATE-type enumerator value that specifies the device power state of the root hub.

RhDeviceWake

On output, a WDMUSB_POWER_STATE-type enumerator value that specifies whether the root hub is in a wake state.

RhSystemWake

On output, a WDMUSB_POWER_STATE-type enumerator value that specifies whether the root hub can wake the system.

LastSystemSleepState

On output, a WDMUSB_POWER_STATE-type enumerator value that specifies the last system sleep state.

CanWakeup

A Boolean value that indicates whether the host controller device can wake up the system from the specified system power state. If TRUE, the host controller device can wake up the system. If FALSE, the host controller cannot wake up the system.

IsPowered

A Boolean value that indicates whether the host controller is powered when in the specified system power state. If TRUE, the host controller is powered. If FALSE, the host controller is not powered.

Remarks

The USB_POWER_INFO structure is used with the USBUSER_GET_POWER_STATE_MAP user-mode request. For more information about this request, see IOCTL_USB_USER_REQUEST.

Requirements

Requirement Value
Header usbuser.h (include Usbuser.h)

See also

IOCTL_USB_USER_REQUEST

USB Structures