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

Метод ISpatialAudioObjectRenderStreamBase::GetService (spatialaudioclient.h)

  • Статья

Возвращает дополнительные службы из ISpatialAudioObjectRenderStream.

Синтаксис

HRESULT GetService(
  [in]  REFIID riid,
  [out] void   **service
);

Параметры

[in] riid

Идентификатор интерфейса для запрошенной службы. Клиент должен задать для этого параметра одно из следующих значений REFIID:

IID_IAudioClock

IID_IAudioClock2

IID_IAudioStreamVolume

[out] service

Указатель на переменную указателя, в которую метод записывает адрес экземпляра запрошенного интерфейса. С помощью этого метода вызывающий объект получает подсчитываемую ссылку на интерфейс . Вызывающий объект отвечает за освобождение интерфейса, когда он больше не нужен, путем вызова метода Release интерфейса. Если вызов GetService завершается сбоем, *ppv имеет значение NULL.

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

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

Код возврата Описание
E_POINTER
 Параметр ppv имеет значение NULL.
SPTLAUDCLNT_E_DESTROYED
 ISpatialAudioClient, связанный с пространственным аудиопотоком, был уничтожен.
AUDCLNT_E_DEVICE_INVALIDATED
 Устройство конечной точки аудио отключено, звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом недоступны для использования.
SPTLAUDCLNT_E_INTERNAL
 Произошла внутренняя ошибка.
AUDCLNT_E_UNSUPPORTED_FORMAT
 Носитель, связанный с пространственным аудиопотоком, использует неподдерживаемый формат.

Комментарии

Метод GetService поддерживает следующие интерфейсы служб:

Требования

Требование Значение
Целевая платформа Windows
Header spatialaudioclient.h

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

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase