Método ISpatialAudioClient::IsSpatialAudioStreamAvailable (spatialaudioclient.h)

  • Artigo

Quando bem-sucedido, obtém um valor que indica se o mecanismo de renderização espacial ativo no momento dá suporte ao fluxo de renderização de áudio espacial especificado.

Sintaxe

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

Parâmetros

[in] streamUuid

A ID da interface para a qual a disponibilidade é consultada.

[in, optional] auxiliaryInfo

Uma estrutura que contém informações adicionais a serem usadas quando o suporte é consultado. Para obter mais informações, consulte Comentários.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
SPTLAUDCLNT_E_STREAM_IS_NOT_AVAILABLE
 A interface de fluxo especificada não pode ser ativada pelo mecanismo de renderização ativo no momento.
SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED
 O formato de metadados fornecido no parâmetro auxiliaryInfo não é compatível com o mecanismo de renderização atual. Para obter mais informações, consulte Comentários..

Comentários

Ao consultar para ver se o ISpatialAudioObjectRenderStreamForMetadata você pode usar o parâmetro auxilaryInfo para consultar se há suporte para um formato de metadados específico. O exemplo de código a seguir demonstra como inicializar a estrutura PROPVARIANT para marcar para obter suporte para um formato de metadados de exemplo.

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

Se o formato de metadados especificado não tiver suporte, IsSpatialAudioStreamAvailable retornará SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho spatialaudioclient.h

Confira também

ISpatialAudioClient