Método IApoAuxiliaryInputConfiguration::IsInputFormatSupported (audioenginebaseapo.h)

  • Artículo

Comprueba que el APO admite un formato de entrada auxiliar específico.

Sintaxis

HRESULT IsInputFormatSupported(
  IAudioMediaType *pRequestedInputFormat,
  IAudioMediaType **ppSupportedInputFormat
);

Parámetros

pRequestedInputFormat

Formato de entrada que se va a comprobar.

ppSupportedInputFormat

El APO rellena este parámetro con el formato de entrada admitido más cercano al formato pasado al método .

Valor devuelto

HRESULT

HRESULT Descripción
S_OK Se completó correctamente. El APO debe agregar una referencia a pRequestedInputFormat y devolverla en ppSupportedInputFormat.
S_FALSE No se admite el formato. El APO debe devolver un formato admitido sugerido en ppSupportedInputFormat.
APOERR_FORMAT_NOT_SUPPORTED No se admite el formato. El APO no debe modificar ppSupportedInputFormat
E_POINTER Puntero no válido pasado a esta función.
Otros valores Otro componente está causando un error. El sistema realiza un seguimiento de estos errores.

Comentarios

Si el APO puede aceptar el formato solicitado, debe agregar una referencia al formato solicitado, devolverlo como el formato de salida admitido y devolver S_OK.

Si el APO no puede aceptar el formato solicitado, puede sugerir un formato solicitado alternativo. En este caso, debe crear y devolver el formato sugerido y devolver S_FALSE.

El formato admitido devuelto debe ser "más cercano" al formato solicitado, lo que significa que el formato debe tener los mismos valores para las siguientes propiedades, especificadas en orden de prioridad.

  • formato de ejemplo
  • profundidad de bits
  • número de canales
  • frecuencia de muestreo

El formato sugerido solo puede ser diferente del formato solicitado si se devuelve S_FALSE. Al devolver cualquier error, el formato sugerido debe dejarse intacto.

Esta API se puede llamar en cualquier momento. Los resultados devueltos dependerán del estado interno del APO que las interfaces de usuario externas pueden manipular. Sin embargo, una vez bloqueado el APO para el procesamiento, este formato no puede cambiar y no cambiará.

Es posible que no se llame a este método desde un subproceso de procesamiento en tiempo real.

Requisitos

Requisito Value
Cliente mínimo compatible compilación 20348 de Windows 10
Encabezado audioenginebaseapo.h