Medientypfunktionen

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die DirectShow-Basisklassen bieten Hilfsfunktionen für die Behandlung der AM_MEDIA_TYPE-Struktur .

Die AM_MEDIA_TYPE-Struktur enthält einen Zeiger (der pbFormat-Member ) auf einen anderen Speicherblock, der als Formatblock bezeichnet wird. Wenn Sie mit dieser Struktur arbeiten, müssen Sie daher bei der Speicherbelegung vorsichtig sein, um Speicherverluste zu vermeiden.

Die folgenden Funktionen weisen Arbeitsspeicher zu:

  • CreateMediaType ordnet eine neue AM_MEDIA_TYPE-Struktur und den Formatblock zu.
  • CopyMediaType kopiert in eine vorhandene AM_MEDIA_TYPE-Struktur , ordnet jedoch den Formatblock zu.
  • CreateAudioMediaType initialisiert eine vorhandene AM_MEDIA_TYPE-Struktur und weist optional den Formatblock zu.

Die folgenden Funktionen verfügen über freien Arbeitsspeicher:

  • FreeMediaType gibt den Formatblock frei.
  • DeleteMediaType gibt eine AM_MEDIA_TYPE-Struktur einschließlich des Formatblocks frei.
Funktion BESCHREIBUNG
CopyMediaType Kopiert eine aufgabenseitig zugeordnete AM_MEDIA_TYPE-Struktur .
CreateAudioMediaType Initialisiert eine Medientypstruktur unter Berücksichtigung einer Wellenformatstruktur.
CreateMediaType Ordnet eine AM_MEDIA_TYPE-Struktur aus einer vorhandenen AM_MEDIA_TYPE-Struktur zu und initialisiert sie.
DeleteMediaType Löscht eine task-zugeordnete AM_MEDIA_TYPE-Struktur .
FreeMediaType Gibt eine aufgabenseitig zugeordnete AM_MEDIA_TYPE Struktur aus dem Arbeitsspeicher frei.

 

Anforderungen

Anforderung Wert
Header
Mtype.h (Einschließen von Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)