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 |
---|---|
|
Der Medientyp hat sich gegenüber dem vorherigen Beispiel nicht geändert. |
|
Erfolg. |
|
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 |