Метод 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
Header	audiopolicy.h

См. также раздел

Интерфейс IAudioSessionControl

IAudioSessionControl::SetIconPath