CBaseControlVideo.GetCurrentImage-Methode

Artikel
07/28/2023

[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 GetCurrentImage -Methode ruft eine Kopie des aktuellen Bilds am Renderer ab.

Syntax

HRESULT GetCurrentImage(
   long *pBufferSize,
   long *pVideoImage
);

Parameter

pBufferSize: Zeiger auf die Größe des Ausgabepuffers.
pVideoImage: Zeiger auf den Ausgabepuffer für das Bild.

Rückgabewert

Gibt einen HRESULT-Wert zurück, der von der Implementierung abhängt. kann einer der folgenden Werte oder andere Werte sein, die nicht aufgeführt sind.

Rückgabecode	Beschreibung
E_FAIL	Fehler.
E_INVALIDARG	Ungültiges Argument.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher. Wird zurückgegeben, wenn der pVideoInfo-ParameterNULL ist.
NOERROR	Erfolg.
VFW_E_NOT_PAUSED	Der Vorgang konnte nicht ausgeführt werden, weil der Filter nicht angehalten wurde.

Bemerkungen

Diese Memberfunktion ruft das Bild aus dem Beispiel ab und kopiert es in den Ausgabepuffer. Der Abschnitt des Videos, das in den Ausgabepuffer kopiert wurde, spiegelt das Quellrechteck wider, das über die IBasicVideo-Schnittstelle festgelegt wurde. Es spiegelt nicht das Zielrechteck wider.

Anforderungen

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

Siehe auch

CBaseControlVideo-Klasse

Freigeben über