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.
4/8/2010

This function gets the current device vibration capabilities.

Note:
This API is not supported by Windows Mobile Professional.

Syntax 

int VibrateGetDeviceCaps (
  VIBRATEDEVICECAPS 
vdc
);

Parameters

vdc

[in] The capability the caller is interested in, determined by the VIBRATEDEVICECAPSenumeration.

Return Value

This function returns the number of vibration steps (a number from 0 to 7) that the device hardware supports for the requested vibration capability.

Value Description

0

The device is incapable of providing the requested vibration functionality.

1

The device is capable of providing one level of vibration functionality (vibration can only be turned on or off).

2-7

Each of these values maps to the vibration functionality that is specific to the device to be vibrated.

Remarks

Each VIBRATENOTEstructure can be constructed with the assumption that the device can support all eight levels of vibration functionality. When the vibration song is played, the Vibratefunction will map the level of vibration specified in VIBRATENOTEto one of the supported vibration levels on the device.

Requirements

Header vibrate.h
Library aygshell.lib
Windows Mobile Smartphone 2002 and later

See Also