Compartir a través de


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

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

Syntax

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 Description
S_OK Finalización correcta. 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.

Observaciones

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 puedan manipular. Sin embargo, una vez que el APO está bloqueado para su procesamiento, este formato no puede y no cambiará.

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

Requisitos

Requirement Importancia
Cliente mínimo compatible Compilación 20348 de Windows 10
Header audioenginebaseapo.h