DEVICE_ID

  • Article

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 Preset identifier is used to identify one device from another. Each device has a unique Preset identifier. The Platform identifier is used to identify one platform from another. Each platform has a unique Platform identifier. For example, two different personal digital assistants (PDAs) from the same manufacturer will have two different Preset identifiers, but have the same Platform identifier.

The DEVICE_ID structure allows you to assign platform-specific identifiers. You can set the attributes of the identifiers in any combination. For example, you can set the attributes of the Preset identifier to read-only and the attributes of the Platform identifier to read/write. It is your responsibility to ensure 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

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.