Méthode IAudioProcessingObject ::IsOutputFormatSupported (audioenginebaseapo.h)

Article
02/23/2024

La IsOutputFormatSupported méthode est utilisée pour vérifier qu’un format de sortie spécifique est pris en charge.

Syntaxe

HRESULT IsOutputFormatSupported(
  [in, optional]  IAudioMediaType *pOppositeFormat,
  [in, optional]  IAudioMediaType *pRequestedOutputFormat,
  [out, optional] IAudioMediaType **ppSupportedOutputFormat
);

Paramètres

[in, optional] pOppositeFormat

Pointeur vers une interface IAudioMediaType. Ce paramètre indique le format de sortie. Ce paramètre doit être défini sur NULL pour indiquer que le format de sortie peut être n’importe quel type.

[in, optional] pRequestedOutputFormat

Pointeur vers une interface IAudioMediaType . Ce paramètre indique le format de sortie à vérifier.

[out, optional] ppSupportedOutputFormat

Ce paramètre indique le format de sortie pris en charge le plus proche du format à vérifier.

Valeur retournée

Si l’appel se termine correctement, le paramètre ppSupportedOutputFormat renvoie un pointeur pRequestedOutputFormat et la méthode IsOutputFormatSupported retourne une valeur de S_OK. Sinon, cette méthode retourne l’un des codes d’erreur suivants :

Code de retour	Description
S_FALSE	Le format de la paire format d’entrée/sortie n’est pas pris en charge. Le paramètre ppSupportedOutPutFormat retourne un nouveau format suggéré.
APOERR_FORMAT_NOT_SUPPORTED	Le format n’est pas pris en charge. La valeur de ppSupportedOutputFormat ne change pas.
E_POINTER	Un pointeur non valide a été passé à la fonction . La valeur de ppSupportedOutputFormat ne change pas.
Autres valeurs HRESULT	Ces conditions d’erreur supplémentaires sont suivies par le moteur audio.

Remarques

Il existe des différences dans l’implémentation de la IsOutputFormatSupported méthode par les différentes API. Par exemple, avec certaines implémentations, la sortie ne peut être de type float que lorsque le format d’entrée est de type entier.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible avec Windows Vista et versions ultérieures du système d’exploitation Windows.
Plateforme cible	Universal
En-tête	audioenginebaseapo.h
Bibliothèque	Audioenginebaseapo.idl
IRQL	Tous les niveaux

Voir aussi

IAudioMediaType

IAudioProcessingObject

Partager via