DIPROPSTRING Structure

Gets and retrieves properties as strings.

Syntax

typedef struct DIPROPSTRING {
    DIPROPHEADER diph;
    WCHAR        wsz[MAX_PATH];
} DIPROPSTRING, * LPDIPROPSTRING;;
 
typedef const DIPROPSTRING *LPCDIPROPSTRING;

Members

diph
DIPROPHEADER structure.
wsz
Unicode string that specifies or retrieves the property.

Remarks

The diph member must be initialized as follows:
Member Value
dwSize sizeof(DIPROPSTRING)
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 (HID). 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.
The DIPROP_INSTANCENAME and DIPROP_PRODUCTNAME properties associated with the DIPROPSTRING structure enable advanced applications to perform operations on a Human Interface Device (HID) that are not supported by Microsoft?DirectInput?

Member	Value
dwSize	sizeof(DIPROPSTRING)
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 (HID). 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.

Structure Information

Header dinput.h
Minimum operating systems Windows 98