Share via

DIPROPPOINTER Structure

  • Article

Used in setting and retrieving data values of type UINT_PTR. This is typically a value associated with an application-specific action associated with a device object in an action map, but can also be a function pointer.

Syntax

typedef struct DIPROPPOINTER {
    DIPROPHEADER diph;
    UINT_PTR uData;
} DIPROPPOINTER, *LPDIPROPPOINTER;

Members

  • diph
    DIPROPHEADER structure.
  • uData
    Application-defined value of type UINT_PTR, which represents the uAppData value (from an action map) that is associated with a device control.

Remarks

The diph member must be initialized as follows:

Member Value
dwSize sizeof(DIPROPPOINTER)
dwHeaderSize sizeof(DIPROPHEADER)
dwObj

If the dwHow member is DIPH_DEVICE, this member must be 0.

If the dwHow member is DIPH_BYID, this member must be the identifier for the object whose property setting is to be set or retrieved.

If the dwHow member is DIPH_BYOFFSET, this member must be a data format offset for the object whose property setting is to be set or retrieved. For example, if the c_dfDIMouse data format is selected, it must be one of the DIMOFS_* values.

If the dwHow member is DIPH_BYUSAGE, the device must be a Human Interface Device (human interface device). The device object will be identified by the HID usage page and usage values in packed form.
dwHow Specifies how the dwObj member should be interpreted. See the preceding description of the dwObj member for details.