Audiofunktionen

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Für Audiofunktionen gibt IAMStreamConfig::GetStreamCaps ein Array von Paaren von AM_MEDIA_TYPE - und AUDIO_STREAM_CONFIG_CAPS-Strukturen zurück. Wie bei Video können Sie dies verwenden, um alle Arten von Audiofunktionen auf dem Pin verfügbar zu machen, z. B. die Datenrate und ob mono oder stereo unterstützt wird.

Videobezogene Beispiele zu GetStreamCaps finden Sie unter Videofunktionen.

Angenommen, Sie unterstützen das PCM-Wellenformat (Pulse Code Modulation) (wie durch die WAVEFORMATEX-Struktur dargestellt) mit Samplingraten von 11.025, 22.050 und 44.100 Samples pro Sekunde, die alle mit 8- oder 16-Bit-Mono- oder Stereodatensätzen verwendet werden. In diesem Fall würden Sie zwei Strukturpaare anbieten. Das erste Paar verfügt über eine AUDIO_STREAM_CONFIG_CAPS-Funktionsstruktur , die besagt, dass Sie mindestens 11.025 bis maximal 22.050 Stichproben pro Sekunde mit einer Granularität von 11.025 Stichproben pro Sekunde unterstützen (Granularität ist der Unterschied zwischen unterstützten Werten); ein Minimum von 8 Bit bis maximal 16 Bit pro Sample mit einer Granularität von 8 Bit pro Sample; und mindestens ein Kanal und maximal zwei Kanäle. Der Medientyp des ersten Paares wäre Ihr PCM-Standardformat in diesem Bereich, vielleicht 22 Kilohertz (kHz), 16-Bit-Stereo. Ihr zweites Paar wäre eine Funktion mit 44.100 für minimale und maximale Stichproben pro Sekunde. 8-Bit (Minimum) und 16-Bit (Maximum) Bits pro Sample mit einer Granularität von 8 Bit pro Sample; und mindestens ein Kanal und maximal zwei Kanäle. Der Medientyp wäre Ihr Standardformat mit 44 kHz, vielleicht 44 kHz 16-Bit-Stereo.

Wenn Sie Nicht-PCM-Wellenformate unterstützen, kann der von dieser Methode zurückgegebene Medientyp anzeigen, welche Nicht-PCM-Formate (mit einer Standard-Abtastrate, Bitrate und Kanälen) unterstützt werden, und die Funktionsstruktur, die diesen Medientyp begleitet, kann beschreiben, welche anderen Sampleraten, Bitraten und Kanäle Sie unterstützen.

Verfügbarmachen von Erfassungs- und Komprimierungsformaten