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 |
---|---|
|
El motor de representación activo actualmente no puede activar la interfaz de secuencia especificada. |
|
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 |