IApoAuxiliaryInputConfiguration ::IsInputFormatSupported, méthode (audioenginebaseapo.h)

Vérifie qu’un format d’entrée auxiliaire spécifique est pris en charge par l’APO.

Syntaxe

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

Paramètres

pRequestedInputFormat

Format d’entrée à vérifier.

ppSupportedInputFormat

L’APO remplit ce paramètre avec le format d’entrée pris en charge le plus proche du format transmis à la méthode.

Valeur de retour

HRESULT

Remarques

Si l’APO peut accepter le format demandé, il doit ajouter une référence au format demandé, renvoyer ce format en tant que format de sortie pris en charge et retourner S_OK.

Si l’APO ne peut pas accepter le format demandé, il peut suggérer un autre format demandé. Dans ce cas, il doit créer et renvoyer le format suggéré et retourner S_FALSE.

Le format pris en charge retourné doit être « le plus proche » du format demandé, ce qui signifie que le format doit avoir les mêmes valeurs pour les propriétés suivantes, spécifiées dans l’ordre de priorité.

• exemple de format
• profondeur de bits
• nombre de canaux
• taux d’échantillonnage

Le format suggéré peut uniquement être différent du format demandé si S_FALSE est retourné. Lorsque vous retournez un échec, le format suggéré doit être laissé inchangé.

Cette API peut être appelée à tout moment. Les résultats retournés dépendent de l’état interne de l’APO qui peut être manipulé par des interfaces utilisateur externes. Une fois l’APO verrouillée pour le traitement, toutefois, ce format ne peut pas et ne sera pas modifié.

Cette méthode peut ne pas être appelée à partir d’un thread de traitement en temps réel.

Spécifications