Метод IAudioClient::Stop (audioclient.h)

Метод Stop останавливает аудиопоток.

Синтаксис

HRESULT Stop();

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

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

Код возврата Описание
AUDCLNT_E_NOT_INITIALIZED
Клиент не инициализирован.
AUDCLNT_E_SERVICE_NOT_RUNNING
Служба звука Windows не запущена.

Комментарии

Этот метод требует предварительной инициализации интерфейса IAudioClient . Все вызовы этого метода будут завершаться ошибкой AUDCLNT_E_NOT_INITIALIZED до тех пор, пока клиент не инициализирует аудиопоток, вызвав метод IAudioClient::Initialize .

Stop — это метод управления, который останавливает работающий аудиопоток. Этот метод останавливает потоковую передачу данных через подключение клиента к обработчику звука. Остановка потока замораживает звуковые часы потока в текущей позиции потока. Последующий вызов IAudioClient::Start приводит к возобновлению выполнения потока из этой позиции. При необходимости клиент может вызвать метод IAudioClient::Reset , чтобы сбросить позицию во время остановки потока.

Примеры кода, вызывающие метод Stop , см. в следующих разделах:

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header audioclient.h

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

Интерфейс IAudioClient

IAudioClient::Initialize

IAudioClient::Reset

IAudioClient::Start