IDirectInputDevice7::SetDataFormat

The IDirectInputDevice7::SetDataFormat method sets the data format for the DirectInput device.

HRESULT SetDataFormat(
  LPCDIDATAFORMAT lpdf  
);

Parameters

lpdf

Address of a structure that describes the format of the data that the DirectInputDevice should return. An application can define its own DIDATAFORMAT structure or use one of the following predefined global variables:

• c_dfDIKeyboard
• c_dfDIMouse
• c_dfDIMouse2
• c_dfDIJoystick
• c_dfDIJoystick2

Return Values

If the method succeeds, the return value is DI_OK.

If the method fails, the return value can be one of the following error values:

Remarks

The data format must be set before the device can be acquired by using the IDirectInputDevice7::Acquire method. It is necessary to set the data format only once. The data format cannot be changed while the device is acquired.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dinput.h.
  Import Library: Use dinput.lib.

See Also

IDirectInputDevice7::GetDeviceState