DEVICE_ID (Windows CE 5.0)

This structure allows you to uniquely identify a Windows CE device by providing two separate identifiers that are combined to create a single globally unique identifier (GUID) for the device.

typedef struct _DEVICE_ID {
  DWORD dwSize;
  DWORD dwPresetIDOffset;
  DWORD dwPresetIDBytes;
  DWORD dwPlatformIDOffset;
  DWORD dwPlatformIDBytes;
} DEVICE_ID, *PDEVICE_ID;

Members

dwSize

Size of the allocated structure and memory for the identifiers.

The caller must allocate enough memory for the structure and the identifiers.

dwPresetIDOffset

Number of bytes from the beginning of the structure to where the Preset identifier is located.

dwPresetIDBytes

Number of bytes used to store the Preset identifier.

If this value is set to zero, no Preset identifier is available.

dwPlatformIDOffset

Number of bytes from the beginning of the structure to where the Platform identifier is located.

dwPlatformIDBytes

Number of bytes used to store the Platform identifier.

If this value is set to zero, no Platform identifier is available.

Remarks

The Platform identifier is used to identify one unique hardware platform from another.

The Preset identifier is used to identify one unique device type from another.

For example, two different personal digital assistants (PDAs) from the same manufacturer have two different Platform identifiers, but they have the same Preset identifier.

You are responsible for ensuring that the combination of Preset and Platform identifiers is unique across different products.

Requirements

OS Versions: Windows CE 2.10 and later.
Header: Pkfuncs.h.

See Also

IOCTL_HAL_GET_DEVICEID

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.