通过

IAudioSessionControl：：GetIconPath 方法 (audiopolicy.h)

  • 项目

GetIconPath 方法检索音频会话的显示图标的路径。

语法

HRESULT GetIconPath(
  [out] LPWSTR *pRetVal
);

参数

[out] pRetVal

指向指针变量的指针，方法在其中写入以 null 结尾的宽字符字符串的地址，该字符串指定包含图标的.ico、.dll 或 .exe 文件的完全限定路径。 方法为字符串分配存储。 当不再需要存储时，调用方负责通过调用 CoTaskMemFree 函数来释放存储。 有关图标路径和 CoTaskMemFree 的信息，请参阅Windows SDK文档。

返回值

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

返回代码 说明
E_POINTER
 参数 pRetVal 为 NULL。
E_OUTOFMEMORY
 内存不足。
AUDCLNT_E_DEVICE_INVALIDATED
 音频终结点设备已拔出，或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows 音频服务未运行。

注解

如果客户端尚未调用 IAudioSessionControl：：SetIconPath 来设置显示图标，则字符串将为空。 如果没有客户端指定的图标可用，则 Sndvol 程序使用客户端应用程序窗口中的图标来标记音频会话的音量控件。

要求

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

另请参阅

IAudioSessionControl 接口

IAudioSessionControl：：SetIconPath