CImageAllocator.NotifyMediaType-Methode

Artikel
07/28/2023

[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 NotifyMediaType -Methode informiert das Objekt des aktuellen Medientyps.

Syntax

void NotifyMediaType(
   CMediaType *pMediaType
);

Parameter

pMediaType: Zeiger auf ein CMediaType-Objekt oder NULL , um den Medientyp zu löschen.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Der Besitzerfilter sollte diese Methode immer dann aufrufen, wenn sich der Medientyp ändert. In der Regel tritt dies auf, wenn der Pin zum ersten Mal eine Verbindung herstellt, und nach einer dynamischen Formatänderung. Der Zuteilungsgeber verwendet den Medientyp, um die vorgeschlagenen Zuordnungseigenschaften zu überprüfen, und auch, wenn Medienbeispiele erstellt werden.

Das CImageAllocator-Objekt speichert den pMediaType-Zeiger in der m_pMediaType Membervariablen. Wenn der Aufrufer daher das CMediaType-Objekt freigeben muss, sollte er den Zuteilungsvorgang aktualisieren, indem er diese Methode erneut aufruft, entweder mit einem neuen Zeiger oder mit einem NULL-Wert . Andernfalls kann ein Fehler auftreten, wenn der Zuweisungsgeber versucht, auf den alten Zeiger zu verweisen.

Anforderungen

Anforderung	Wert
Header	Winutil.h (streams.h einschließen)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CImageAllocator-Klasse

Freigeben über