CMediaSample.GetMediaType-Methode

[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.]

Die GetMediaType -Methode ruft den Medientyp ab, wenn sich der Medientyp vom vorherigen Beispiel unterscheidet. Diese Methode implementiert die IMediaSample::GetMediaType-Methode .

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 der in der folgenden Tabelle dargestellten HRESULT-Werte zurück.

Rückgabecode Beschreibung
S_FALSE
Der Medientyp hat sich gegenüber dem vorherigen Beispiel nicht geändert.
S_OK
Erfolg.
E_OUTOFMEMORY
Nicht genügend Arbeitsspeicher.

Bemerkungen

Wenn Sie mit dem Medientyp fertig sind, geben Sie den Speicherblock frei, indem Sie die DeleteMediaType-Hilfsprogrammfunktion aufrufen.

Die Membervariable CMediaSample::m_pMediaType gibt den Medientyp an. Die Membervariable CMediaSample::m_dwFlags gibt an, ob sich der Medientyp geändert hat.

Anforderungen

Anforderung Wert
Header
Amfilter.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CMediaSample-Klasse