Share via

IDeviceTopology：：GetDeviceId 方法 (devicetopology.h)

  • 项目

GetDeviceId 方法获取由 device-topology 对象表示的设备的设备标识符。

语法

HRESULT GetDeviceId(
  [out] LPWSTR *ppwstrDeviceId
);

参数

[out] ppwstrDeviceId

指向指针变量的指针，方法将包含设备标识符的以 null 结尾的宽字符字符串的地址写入其中。 方法为字符串分配存储。 调用方负责通过调用 CoTaskMemFree 函数，在不再需要存储时释放存储。 如果 GetDeviceId 调用失败， 则 *ppwstrDeviceId 为 NULL。 有关 CoTaskMemFree 的信息，请参阅 Windows SDK 文档。

返回值

如果该方法成功，则它会返回 S_OK。 如果失败，可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
D_POINTER
 指针 ppwstrDeviceId 为 NULL。
E_OUTOFMEMORY
 内存不足。

注解

从此方法获取的设备标识符可用作 IMMDeviceEnumerator：：GetDevice 方法的输入参数。

有关使用 GetDeviceId 方法的代码示例，请参阅 使用 IKsControl 接口访问音频属性。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

IDeviceTopology 接口

IMMDeviceEnumerator：：GetDevice