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

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

  • Статья

Метод GetSessionIdentifier извлекает идентификатор звукового сеанса.

Синтаксис

HRESULT GetSessionIdentifier(
  [out] LPWSTR *pRetVal
);

Параметры

[out] pRetVal

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

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

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

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

Комментарии

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

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

Требования

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

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

IAudioSessionControl2