imDSPDevice::GetName 方法 (mswmdm.h)
GetName 方法检索设备的名称。
语法
HRESULT GetName(
[out] LPWSTR pwszName,
[in] UINT nMaxChars
);
参数
[out] pwszName
指向接收设备名称字符串的 16 位 Unicode 字符数组的指针。
[in] nMaxChars
要复制到字符串的最大字符数。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
注解
LPWSTR 字符串类型是 16 位 Unicode 字符串,不接受字节大小的字符。 若要将 LPCSTR) (字节大小的字符串转换为 LPWSTR 字符串,请使用 MultiByteToWideChar 函数,如 Microsoft Windows 文档中所述。
设备名称不得包含尾随空格。
必须实现此方法。 它不得返回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 有关详细信息,请参阅 必需接口和可选接口。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |