CopyMediaType-Funktion

[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 CopyMediaType-Funktion kopiert eine AM_MEDIA_TYPE-Struktur in eine andere Struktur, einschließlich des Formatblocks.

Syntax

HRESULT WINAPI CopyMediaType(
         AM_MEDIA_TYPE *pmtTarget,
   const AM_MEDIA_TYPE *pmtSource
);

Parameter

pmtTarget

Zeiger auf eine AM_MEDIA_TYPE-Struktur . Die -Methode kopiert den Medientyp in diese Struktur.

pmtSource

Zeiger auf eine zu kopierende Quellstruktur AM_MEDIA_TYPE .

Rückgabewert

Gibt S_OK oder E_OUTOFMEMORY zurück.

Bemerkungen

Diese Funktion ordnet den Arbeitsspeicher für den Formatblock zu. Wenn der parameter pmtTarget bereits einen zugeordneten Formatblock enthält, tritt ein Speicherverlust auf. Um einen Speicherverlust zu vermeiden, rufen Sie FreeMediaType auf, bevor Sie diese Funktion aufrufen.

Nachdem die Methode zurückgegeben wurde, rufen Sie FreeMediaType auf pmtTarget auf, um den Formatblock frei zu geben.

Anforderungen

Siehe auch

Medientypfunktionen