Microsoft DirectX 8.1 (Visual Basic)

DirectInputEnumDeviceObjects.GetItem

Retrieves an object describing the specified device object.

object.GetItem(index As Long) _
  As DirectInputDeviceObjectInstance

Parts

object
Resolves to a DirectInputEnumDeviceObjects object.
index
Index of the enumerated item to retrieve.

Return Values

Returns a DirectInputDeviceObjectInstance object whose methods can be used to retrieve information about the device object.

Error Codes

If the method fails, an error is raised and Err.Number is set.

Remarks

To get the number of entries in the DirectInputEnumDeviceObjects first call the DirectInputEnumDeviceObjects.GetCount method.

Applications should not rely on this method to determine whether certain keyboard keys or indicator lights are present, as these objects might be enumerated even though they are not present. Although the basic set of available objects can be determined from the device subtype, there is no reliable way of determining whether extra objects such as the menu key are available.