Microsoft Windows CE 3.0  

OhcdPdd_CheckConfigPower

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function checks power for a requested configuration.

BOOL
OhcdPdd_CheckConfigPower(
UCHAR
bPort
,
DWORD
dwConfigPower
,
DWORD
dwTotalPower
);

Parameters

bPort
[IN] Specifies the root hub port number.
dwConfigPower
[IN] Specifies the power, in milliamps, required by the configuration being checked.
dwTotalPower
[IN] Specifies the power, in milliamps, drawn by other devices on this port.

Return Values

TRUE indicates that the USB system supports the configuration. FALSE indicates that a configuration is not supported.

Remarks

When a device is initially attached to the bus, OHC interface selects a configuration, based on the power requirements of the system by calling this function for each configuration until one that is supported is found. If no configurations in a device are supported, the device is not configured.

This enables the platform to perform additional processing if necessary, such as checking whether the Windows CE–based platform is using batteries or external power, or possibly sampling the current system power status.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Ohcdddsi.h    
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.


 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.