Fonctionnalités audio

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngineet audio/vidéo capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et capture audio/vidéo dans Media Foundation au lieu de directShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Pour les fonctionnalités audio, IAMStreamConfig ::GetStreamCaps retourne un tableau de paires de structures AM_MEDIA_TYPE et AUDIO_STREAM_CONFIG_CAPS. Comme pour la vidéo, vous pouvez l’utiliser pour exposer toutes sortes de fonctionnalités audio sur la broche, telles que le débit de données et s’il prend en charge mono ou stéréo.

Pour obtenir des exemples vidéo relatifs à GetStreamCaps, consultez Fonctionnalités vidéo.

Supposons que vous preniez en charge le format d’onde d’impulsion (PCM) (tel que représenté par la structure WAVEFORMATEX) aux taux d’échantillonnage de 11 025, 22 050 et 44 100 échantillons par seconde, tous à 8 ou 16 bits mono ou stéréo. Dans ce cas, vous proposeriez deux paires de structures. La première paire aurait une structure de capacité de AUDIO_STREAM_CONFIG_CAPS indiquant que vous prenez en charge un minimum de 11 025 à un maximum de 22 050 échantillons par seconde avec une granularité de 11 025 échantillons par seconde (la granularité est la différence entre les valeurs prises en charge) ; un minimum de 8 bits à un nombre maximal de 16 bits par échantillon avec une granularité de 8 bits par échantillon ; et un canal minimum et deux canaux maximum. Le type de média de la première paire serait votre format PCM par défaut dans cette plage, peut-être 22 kilohertz (kHz), stéréo 16 bits. Votre deuxième paire serait une fonctionnalité montrant 44 100 échantillons minimum et maximum par seconde ; 8 bits (minimum) et 16 bits (maximum) par échantillon, avec une granularité de 8 bits par échantillon ; et un canal minimum et deux canaux maximum. Le type de média serait votre format 44 kHz par défaut, peut-être 44 kHz 16 bits stéréo.

Si vous prenez en charge les formats d’onde non PCM, le type de média retourné par cette méthode peut afficher les formats non PCM que vous prenez en charge (avec un taux d’échantillonnage, un débit de bits et des canaux par défaut) et la structure des fonctionnalités qui accompagnent ce type de média peut décrire les autres taux d’échantillonnage, les taux de bits et les canaux que vous prenez en charge.

Rubriques connexes

exposant les formats de capture et de compression