DIPROPGUIDANDPATH Structure

  • Article

Used to access properties whose values represent a globally unique identifier (GUID) and a path.

Syntax

typedef struct DIPROPGUIDANDPATH {
    DIPROPHEADER diph;
    GUID guidClass;
    WCHAR wszPath[MAX_PATH];
} DIPROPGUIDANDPATH, *LPDIPROPGUIDANDPATH;

Members

  • diph
    DIPROPHEADER structure.
  • guidClass
    Class GUID for the object.
  • wszPath
    Returned path for the object. This is a Unicode string.

Remarks

The diph member must be initialized as follows:

Member Value
dwSize sizeof(DIPROPGUIDANDPATH).
dwHeaderSize sizeof(DIPROPHEADER).
dwObj For this structure, this member must be set to 0.
dwHow Specifies how the dwObj member should be interpreted. For this structure, dwHow should be DIPH_DEVICE.

The DIPROP_GUIDANDPATH property associated with the DIPROPGUIDANDPATH structure enables advanced applications to perform operations on a Human Interface Device (human interface device) that are not supported by DirectInput.

The application calls the IDirectInputDevice8::GetProperty method with DIPROP_GUIDANDPATH as the rguidProp parameter. The class GUID of the device is returned in the guidClass member of the DIPROPGUIDANDPATH structure, and the device interface path is returned in the wszPath member. The application can then call the CreateFile function on this path to access the device directly.