The IDirectInputDevice::SetProperty method sets properties that define the device behavior. These properties include input buffer size and axis mode.
HRESULT SetProperty(
REFGUID rguidProp,
LPCDIPROPHEADER pdiph
);
| DIPROP_AUTOCENTER | ||
| Specifies whether device objects are self-centering. This setting applies to the entire device, rather than to any particular object, so the dwHow member of the associated DIPROPDWORD structure must be DIPH_DEVICE. The dwData member may be one of the following values: DIPROPAUTOCENTER_OFF: The device should not automatically center when the user releases the device. An application that uses force-feedback should disable the auto-centering spring before playing effects. DIPROPAUTOCENTER_ON: The device should automatically center when the user releases the device. For example, in this mode, a joystick would engage the self-centering spring. Note that the use of force feedback effects may interfere with the auto-centering spring. Some devices disable the auto-centering spring when a force-feedback effect is played. Not all devices support the auto-center property. |
||
| DIPROP_AXISMODE | ||
| Sets the axis mode. The value being set (DIPROPAXISMODE_ABS or DIPROPAXISMODE_REL) must be specified in the dwData member of the associated DIPROPDWORD structure. See the description for the pdiph parameter for more information. This setting applies to the entire device, so the dwHow member of the associated DIPROPDWORD structure must be set to DIPH_DEVICE. |
||
| DIPROP_BUFFERSIZE | ||
| Sets the input-buffer size. The value being set must be specified in the dwData member of the associated DIPROPDWORD structure. See the description for the pdiph parameter for more information. This setting applies to the entire device, so the dwHow member of the associated DIPROPDWORD structure must be set to DIPH_DEVICE. |
||
| DIPROP_CALIBRATIONMODE | ||
| Allows the application to specify whether DirectInput should retrieve calibrated or uncalibrated data from an axis. By default, DirectInput retrieves calibrated data. Setting the calibration mode for the entire device is equivalent to setting it for each axis individually. The dwData member of the DIPROPDWORD structure may be one of the following values: DIPROPCALIBRATIONMODE_COOKED: DirectInput should return data after applying calibration information. This is the default mode. DIPROPCALIBRATIONMODE_RAW: DirectInput should return raw, uncalibrated data. This mode is typically used only by Control Panel–type applications. Note that setting a device into raw mode causes the dead zone, saturation, and range settings to be ignored. |
||
| DIPROP_DEADZONE | ||
| Sets the value for the dead zone of a joystick, in the range 0 to 10,000, where 0 indicates there is no dead zone, 5,000 indicates that the dead zone extends over 50 percent of the physical range of the axis on both sides of center, and 10,000 indicates that the entire physical range of the axis is dead. When the axis is within the dead zone, it is reported as being at the center of its range. This setting can be applied to either the entire device or to a specific axis. |
||
| DIPROP_FFGAIN | ||
| Sets the gain for the device. This setting applies to the entire device, rather than to any particular object, so the dwHow member of the associated DIPROPDWORD structure must be DIPH_DEVICE. The dwData member contains a gain value that is applied to all effects created on the device. The value is an integer in the range 0 to 10,000, specifying the amount by which effect magnitudes should be scaled for the device. For example, a value of 10,000 indicates that all effect magnitudes are to be taken at face value. A value of 9,000 indicates that all effect magnitudes are to be reduced to 90% of their nominal magnitudes. Setting a gain value is useful when an application wishes to scale down the strength of all force feedback effects uniformly, based on user preferences. Unlike other properties, the gain can be set when the device is in an acquired state. |
||
| DIPROP_RANGE | ||
| Sets the range of values an object can possibly report. The minimum and maximum values are taken from the lMin and lMax members of the associated DIPROPRANGE structure. | ||
| For some devices, this is a read-only property. You cannot set a reverse range; lMax must be greater than lMin. |
||
| DIPROP_SATURATION | ||
| Sets the value for the saturation zones of a joystick, in the range 0 to 10,000. The saturation level is the point at which the axis is considered to be at its most extreme position. For example, if the saturation level is set to 9,500, then the axis reaches the extreme of its range when it has moved 95 percent of the physical distance from its center position (or from the deadzone). This setting can be applied to either the entire device or to a specific axis. |
||
If the method succeeds, the return value is DI_OK or DI_PROPNOEFFECT.
If the method fails, the return value may be one of the following error values:
| DIERR_INVALIDPARAM |
| DIERR_NOTINITIALIZED |
| DIERR_OBJECTNOTFOUND |
| DIERR_UNSUPPORTED |
The buffer size determines the amount of data that the buffer can hold between calls to the IDirectInputDevice::GetDeviceData method before data is lost. This value may be set to zero to indicate that the application will not be reading buffered data from the device. If the buffer size in the dwData member of the DIPROPDWORD structure is too large to be supported by the device, the largest possible buffer size is set. To determine whether the requested buffer size was set, retrieve the buffer-size property and compare the result with the value you previously attempted to set.
Windows NT: Use version 5.0 or later.
Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in dinput.h.
Import Library: Use dinput.lib.
IDirectInputDevice::GetProperty