Поделиться через

Метод IAudioSessionControl2::GetSessionInstanceIdentifier (audiopolicy.h)

  • Статья

Метод GetSessionInstanceIdentifier извлекает идентификатор экземпляра звукового сеанса.

Синтаксис

HRESULT GetSessionInstanceIdentifier(
  [out] LPWSTR *pRetVal
);

Параметры

[out] pRetVal

Указатель на адрес строки с расширенными символами, завершающейся null, которая получает идентификатор определенного экземпляра звукового сеанса. Строка выделяется этим методом и должна быть освобождена вызывающим объектом путем вызова CoTaskMemFree. Сведения о CoTaskMemFree см. в документации по Windows SDK.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Возвращаемое значение Описание
E_POINTER
 pRetVal имеет значение NULL.
AUDCLNT_E_DEVICE_INVALIDATED
 Звуковой сеанс отключен на звуковом устройстве по умолчанию.

Комментарии

Каждый экземпляр звукового сеанса определяется уникальной строкой. Эта строка представляет конкретный экземпляр звукового сеанса и, в отличие от идентификатора сеанса, является уникальным для всех экземпляров. Если воспроизводится два экземпляра приложения, они будут иметь разные идентификаторы экземпляров сеанса. Идентификатор, полученный getSessionInstanceIdentifier , отличается от идентификатора сеанса, который используется всеми экземплярами сеанса. Чтобы получить идентификатор сеанса, вызовите IAudioSessionControl2::GetSessionIdentifier.

GetSessionInstanceIdentifier проверяет, отключен ли сеанс на устройстве по умолчанию. Он извлекает строку идентификатора, кэшированную звуковым клиентом для устройства. Если идентификатор экземпляра сеанса не найден, этот метод извлекает его из подсистемы аудио. Пример кода о получении идентификатора экземпляра сеанса см. в разделе Получение утиных событий с устройства связи.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header audiopolicy.h

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

IAudioSessionControl2

Использование устройства связи