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

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

  • Статья

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

Синтаксис

HRESULT GetProcessId(
  [out] DWORD *pRetVal
);

Параметры

[out] pRetVal

Указатель на переменную DWORD , которая получает идентификатор процесса звукового сеанса.

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

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

Возвращаемое значение Описание
E_POINTER
 pRetVal имеет значение NULL.
AUDCLNT_S_NO_SINGLE_PROCESS
 Сеанс охватывает несколько процессов. В этом случае pRetVal получает начальный идентификатор процесса, создавшего сеанс. Чтобы использовать это значение, включите следующее определение:

#define AUDCLNT_S_NO_SINGLE_PROCESS AUDCLNT_SUCCESS (0x00d)
AUDCLNT_E_DEVICE_INVALIDATED
 Звуковой сеанс отключен на звуковом устройстве по умолчанию.

Комментарии

Этот метод перезаписывает значение, переданное приложением в pRetVal.

GetProcessId проверяет, отключен ли звуковой сеанс на устройстве по умолчанию или сеанс переключился на другой поток. В случае переключения потоков этот метод передает сведения о состоянии нового потока в сеанс. Сведения о состоянии включают элементы управления громкости, метаданные (отображаемое имя, путь к значку) и хранилище свойств сеанса.

Требования

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

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

IAudioSessionControl2