Метод 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. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.
Код возврата | Описание |
---|---|
|
Параметр ppv имеет значение NULL. |
|
ISpatialAudioClient, связанный с пространственным аудиопотоком, был уничтожен. |
|
Устройство конечной точки аудио отключено, звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом недоступны для использования. |
|
Произошла внутренняя ошибка. |
|
Носитель, связанный с пространственным аудиопотоком, использует неподдерживаемый формат. |
Комментарии
Метод GetService поддерживает следующие интерфейсы служб:
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | spatialaudioclient.h |