CDrawImage.DrawImage-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 DrawImage -Methode zeichnet einen Videoframe im Videofenster.
Syntax
BOOL DrawImage(
IMediaSample *pMediaSample
);
Parameter
-
pMediaSample
-
Zeiger auf die IMediaSample-Schnittstelle des Beispiels, das das Bild enthält.
Rückgabewert
Gibt TRUE zurück, wenn dies erfolgreich war, oder andernfalls FALSE .
Bemerkungen
Diese Methode delegiert an CDrawImage::FastRender oder CDrawImage::SlowRender, je nachdem, ob der Filter die Zuweisung besitzt, die das Beispiel bereitgestellt hat. Wenn der Filter der Besitzer der Zuweisung ist, ist das Beispiel garantiert ein CImageSample-Objekt . In diesem Fall verwendet das Beispiel freigegebenen Arbeitsspeicher, der von GDI zugeordnet ist, und das Bild kann entweder mit BitBlt oder StretchBlt gezeichnet werden. Andernfalls müssen die Bilder mit den langsameren Funktionen SetDIBitsToDevice oder StretchDIBits gezeichnet werden.
In Debugbuilds ruft diese Methode DisplaySampleTimes auf, um die Zeitstempel des Beispiels über das Videobild zu zeichnen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|