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.

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

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

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IMediaSample-Schnittstelle