DirectInputControllerExtension Properties

Gets or sets the axis mode.

Gets or sets the input buffer size. The buffer size determines the amount of data that the buffer can hold between calls to GetDeviceData before data is lost. You can set this value to 0 to indicate that the application does not read buffered data from the device. If the buffer size is too large for the device to support it, then the largest possible buffer size is set. However, this property always returns the buffer size set using the BufferSize property, even if the buffer cannot be supported because it is too large.

Gets the class GUID for the device. This property lets advanced applications perform operations on a human interface device that are not supported by DirectInput.

The parent controller of this extension.

Direct Input device sub type.

Direct Input device type.

Force feedback driver Guid.

Gets or sets the force feedback gain of the device. The gain value is applied to all effects created on the device. The value is an integer in the range from 0 through 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 percent of their nominal magnitudes. DirectInput always checks the gain value before setting the gain property. If the gain is outside of the range (less than zero or greater than 10,000), setting this property will raise an exception. Otherwise, no exception if successful, even if the device does not support force feedback. Setting a gain value is useful when an application wants 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.

Instance Guid.

Gets or sets the friendly instance name of the device. This property exists for advanced applications that want to change the friendly instance name of a device (as returned in the tszInstanceName member of the DeviceInstance structure) to distinguish it from similar devices that are plugged in simultaneously. Most applications should have no need to change the friendly name.

Gets the device interface path for the device. This property lets advanced applications perform operations on a human interface device that are not supported by DirectInput.

Is the device a HID?

Gets the instance number of a joystick. This property is not implemented for the mouse or keyboard.

Product Guid.

Gets the product ID of a HID device. This property applies to the entire device, rather than to any particular object.

Gets or sets the friendly product name of the device. This property exists for advanced applications that want to change the friendly product name of a device (as returned in the tszProductName member of the DeviceInstance structure) to distinguish it from similar devices which are plugged in simultaneously. Most applications should have no need to change the friendly name. This setting applies to the entire device. Setting the product name is only useful for changing the user-defined name of an analog joystick on Microsoft Windows 98, Windows 2000, and Windows Millennium Edition (Windows Me) computers. In other cases, attempting to set this property will still return ok. However, the name is not stored in a location used by the getter of this property.

Direct Input raw type.

HID usage.

HID usage page.

Gets the vendor id of a HID device. This property applies to the entire device, rather than to any particular object.