Share via


VibrateGetDeviceCaps

Send Feedback

This function gets the current device vibration capabilities.

int VibrateGetDeviceCaps (
  VIBRATEDEVICECAPS vdc
);

Parameters

  • vdc
    [in] The capability the caller is interested in, determined by the VIBRATEDEVICECAPS enumeration.

Return Values

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 VIBRATENOTE structure can be constructed with the assumption that the device can support all eight levels of vibration functionality. When the vibration song is played, the Vibrate function will map the level of vibration specified in VIBRATENOTE to one of the supported vibration levels on the device.

Requirements

Pocket PC: Not supported
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: Declared in vibrate.h
Library: Use aygshell.lib

See Also

Vibrate

VIBRATEDEVICECAPS

VIBRATENOTE

VibrateStop

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.