Table of contents
TOC
Collapse the table of content
Expand the table of content

Accessing Device Interface Properties

Last Updated: 7/30/2016

In Windows Vista and later versions of Windows, the unified device property model includes device interface properties that characterize a device interface. The unified device property model uses property keys to represent these properties.

Windows Server 2003, Windows XP, and Windows 2000 support most of these device interface class properties. However, these earlier versions of Windows do not support the property keys of the unified device property model. Instead, these versions of Windows use the following mechanisms to represent and access device interface properties:

To maintain compatibility with these earlier versions of Windows, Windows Vista and later versions also support these two ways to access information about a device interface. However, you should use the property keys to access these properties in Windows Vista and later versions.

For a list of the system-defined device interface class properties, see Device Interface Properties. The device interface class properties are listed by their corresponding property keys that you use to access the properties in Windows Vista and later versions. The information that is provided with the property keys includes the corresponding registry entry values, if any, that you can use to access the properties on Windows Server 2003, Windows XP, and Windows 2000.

For information about how to use property keys to access device setup class properties in Windows Vista and later versions, see Accessing Device Interface Properties (Windows Vista and Later).

For information about how to install and use device interfaces, see Device Interface Classes and INF AddInterface Directive.

Accessing Device Interface Properties That Have Corresponding Registry Entry Values

To access device interface properties by using registry entry values on Windows Server 2003, Windows XP, and Windows 2000, first call SetupDiOpenDeviceInterfaceRegKeyand supply the following parameters:

  • Set DeviceInfoSet to a pointer to a device information set that contains the device interface.

  • Set DeviceInterfaceData to a pointer to an SP_DEVICE_INTERFACE_DATA structure that identifies the device interface.

  • Set Reserved to zero.

  • Set samDesired to a REGSAM-typed value that specifies the required access permissions.

If this call to SetupDiOpenDeviceInterfaceRegKey succeeds, SetupDiOpenDeviceInterfaceRegKey returns the requested handle. If the function call fails, SetupDiOpenDeviceInterfaceRegKey returns INVALID_HANDLE_VALUE and a call to GetLastError will return the logged error code.

After you retrieve a handle to the device interface registry key, supply the handle in a call to RegQueryValueEx or RegSetValueEx to retrieve or set the registry entry value that corresponds to the device interface property.

Call the RegCloseKey function to close the class registry key after access to the key is no longer required.

Using SetupDiEnumDeviceInterfaces to Retrieve Information About a Device Interface

Another way to retrieve information about a device interface on Windows Server 2003, Windows XP, and Windows 2000 is by calling SetupDiEnumDeviceInterfaces to retrieve an SP_DEVICE_INTERFACE_DATA structure for the interface. An SP_DEVICE_INTERFACE_DATA structure contains the following information:

  • The Flags member indicates whether a device interface is active or removed, and whether the device is the default interface for the interface class.

  • The InterfaceClassGuild member identifies the interface class GUID.

© 2016 Microsoft