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

Метод ISpatialAudioClient::IsSpatialAudioStreamAvailable (spatialaudioclient.h)

  • Статья

При успешном выполнении получает значение, указывающее, поддерживает ли активный в данный момент механизм пространственной отрисовки указанный поток отрисовки пространственного звука.

Синтаксис

HRESULT IsSpatialAudioStreamAvailable(
  [in]           REFIID            streamUuid,
  [in, optional] const PROPVARIANT *auxiliaryInfo
);

Параметры

[in] streamUuid

Идентификатор интерфейса, для которого запрашивается доступность.

[in, optional] auxiliaryInfo

Структура, содержащая дополнительные сведения для использования при запросе поддержки. Дополнительные сведения см. в подразделе "Примечания".

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

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

Код возврата Описание
SPTLAUDCLNT_E_STREAM_IS_NOT_AVAILABLE
 Указанный потоковый интерфейс не может быть активирован активным в данный момент механизмом отрисовки.
SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED
 Формат метаданных, указанный в параметре auxiliaryInfo , не поддерживается текущим механизмом отрисовки. Дополнительные сведения см. в разделе Примечания.

Комментарии

При запросе, чтобы узнать, может ли ISpatialAudioObjectRenderStreamForMetadata использовать параметр auxilaryInfo, чтобы запросить, поддерживается ли определенный формат метаданных. В следующем примере кода показано, как инициализировать структуру PROPVARIANT, чтобы проверка для поддержки примера формата метаданных.

PROPVARIANT auxiliaryInfo;  
auxiliaryInfo.vt = VT_CLSID;  
auxiliaryInfo.puuid = const_cast<CLSID*>(&CONTOSO_SPATIAL_METADATA_V1_0);

Если указанный формат метаданных не поддерживается, IsSpatialAudioStreamAvailable возвращает SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED.

Требования

   
Целевая платформа Windows
Header spatialaudioclient.h

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

ISpatialAudioClient