?/TD>
Microsoft DirectX 9.0

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:
MemberValue
dwSizesizeof(DIPROPSTRING)
dwHeaderSizesizeof(DIPROPHEADER)
dwObjIf 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.

dwHowSpecifies 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?

Structure Information

Headerdinput.h
Minimum operating systems Windows 98


© 2002 Microsoft Corporation. All rights reserved.