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

Cuando se ejecuta correctamente, obtiene un valor que indica si el motor de representación espacial actualmente activo admite la secuencia de representación de audio espacial especificada.

Sintaxis

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

Parámetros

[in] streamUuid

Identificador de interfaz de la interfaz para la que se consulta la disponibilidad.

[in, optional] auxiliaryInfo

Estructura que contiene información adicional que se usará cuando se consulta el soporte técnico. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
SPTLAUDCLNT_E_STREAM_IS_NOT_AVAILABLE	El motor de representación activo actualmente no puede activar la interfaz de secuencia especificada.
SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED	El motor de representación actual no admite el formato de metadatos proporcionado en el parámetro auxiliaryInfo . Para obtener más información, vea Comentarios.

Comentarios

Al consultar para ver si el ISpatialAudioObjectRenderStreamForMetadata puede usar el parámetro auxilaryInfo para consultar si se admite un formato de metadatos determinado. En el ejemplo de código siguiente se muestra cómo inicializar la estructura PROPVARIANT para comprobar la compatibilidad con un formato de metadatos de ejemplo.

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

Si no se admite el formato de metadatos especificado, IsSpatialAudioStreamAvailable devuelve SPTLAUDCLNT_E_METADATA_FORMAT_IS_NOT_SUPPORTED.

Requisitos

Plataforma de destino	Windows
Encabezado	spatialaudioclient.h

Consulte también

ISpatialAudioClient