IWDFDeviceAssignTransportSettings::AssignReferenceString method

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

The AssignReferenceString method assigns a reference string to a multi-transport device's transport interface.

Syntax

HRESULT AssignReferenceString(
  [in] PCWSTR pcwszReferenceString
);

Parameters

• pcwszReferenceString [in]
  A pointer to a caller-supplied, null-terminated character string that represents a reference string for the transport.

Return value

AssignReferenceString return S_OK if the operation succeeds. Otherwise, this method returns one of the error codes that are defined in Winerror.h.

Remarks

Future versions of the framework might not support the IWDFDeviceAssignTransportSettings interface. Drivers for multi-transport devices should use Windows Portable Devices (WPD) interfaces, which are described in another section of this WDK documentation.

The WDK does not provide a header that defines the IWDFDeviceAssignTransportSettings interface. For information about the interface definition language (IDL) definition of this interface, see IWDFDeviceAssignTransportSettings.

Requirements

See also

IWDFDeviceAssignTransportSettings

Send comments about this topic to Microsoft