CImageAllocator.CreateImageSample-Methode

[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 CreateImageSample -Methode erstellt ein Medienbeispiel.

Syntax

virtual CImageSample* CreateImageSample(
   LPBYTE pData,
   LONG   Length
);

Parameter

Pdata

Zeiger auf einen Puffer der Größe Length, der vom Aufrufer zugeordnet wird.

Länge

Die Länge des Puffers.

Rückgabewert

Gibt ein CImageSample-Objekt zurück.

Bemerkungen

Diese Methode erstellt ein neues Medienbeispiel, das als CImageSample-Objekt implementiert wird. Die IMediaSample::GetPointer-Methode des Beispiels gibt einen Zeiger auf den im pData-Parameter angegebenen Puffer zurück.

Wenn Sie eine neue Zuweisungsklasse von CImageAllocator und eine neue Medienbeispielklasse von CImageSample ableiten, sollten Sie diese Methode überschreiben, um eine instance Ihrer Medienbeispielklasse zu erstellen.

Anforderungen

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

Siehe auch

CImageAllocator-Klasse

CImageAllocator::Alloc