IMediaSample::GetMediaType-Methode (strmif.h)

[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 GetMediaType -Methode ruft den Medientyp ab, wenn sich der Medientyp vom vorherigen Beispiel unterscheidet.

Syntax

HRESULT GetMediaType(
  AM_MEDIA_TYPE **ppMediaType
);

Parameter

ppMediaType

Adresse einer Variablen, die einen Zeiger auf eine AM_MEDIA_TYPE-Struktur empfängt. Wenn sich der Medientyp gegenüber dem vorherigen Beispiel nicht geändert hat, wird *ppMediaType auf NULL festgelegt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die in der folgenden Tabelle gezeigten Werte.

Bemerkungen

Diese Methode ermöglicht es einem Filter, begrenzte Änderungen am Medientyp vorzunehmen, z. B. das Ändern der Palette. Um den Medientyp erheblich zu ändern, müssen die Pins möglicherweise erneut eine Verbindung herstellen und den Medientyp neu aushandeln.

Wenn die Methode S_OK zurückgibt, muss der Aufrufer den Speicher für den Medientyp freigeben, einschließlich des Formatblocks. Sie können die DeleteMediaType-Funktion in der DirectShow-Basisklassenbibliothek verwenden.

Anforderungen

Siehe auch

Fehler- und Erfolgscodes

IMediaSample-Schnittstelle