DIEnumDevicesCallback

Application-defined callback function that receives Microsoft® DirectInput® devices as a result of a call to the IDirectInput8::EnumDevices method.

BOOL CALLBACK DIEnumDevicesCallback(
  LPCDIDEVICEINSTANCE lpddi,  
  LPVOID pvRef  
);

Parameters

lpddi

Address of a DIDEVICEINSTANCE structure that describes the device instance.

pvRef

The application-defined value passed to EnumDevices or EnumDevicesBySemantics as the pvRef parameter.

Return Values

Returns DIENUM_CONTINUE to continue the enumeration or DIENUM_STOP to stop the enumeration.

Remarks

If a single hardware device can function as more than one DirectInput device type, it is enumerated as each device type that it supports. For example, a keyboard with a built-in mouse is enumerated twice: once as a keyboard and once as a mouse. The product GUID is the same for each device, however.

Requirements

  Windows NT/2000/XP: Requires Windows 2000.
  Windows 98/Me: Requires Windows 98 or later. Available as a redistributable for Windows 98.
  Header: Declared in dinput.h.
  Import Library: User-defined.

See Also

DIEnumDevicesBySemanticsCallback