CBaseControlVideo.GetImageSize-Methode

  • Artikel

[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 GetImageSize -Methode ruft Videobildgrößeninformationen ab.

Syntax

HRESULT GetImageSize(
   VIDEOINFOHEADER *pVideoInfo,
   long            *pBufferSize,
   RECT            *pSourceRect
);

Parameter

pVideoInfo

Zeiger auf eine VIDEOINFOHEADER-Struktur , die ausgefüllt werden soll.

pBufferSize

Zeiger auf die Größe des Videopuffers.

pSourceRect

Zeiger auf die Rechteckdimensionen des Quellvideos.

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. Das Datenformat ist nicht kompatibel.
E_UNEXPECTED
 Unerwarteter Fehler. Mindestens ein Argument ist NULL.
NOERROR
 Erfolg.

Bemerkungen

Diese Memberfunktion ist eine Hilfsfunktion, die zum Erstellen von Speicherbildrenderings von DIB-Bildern verwendet wird. Es wird von der Basisklassenimplementierung von CBaseControlVideo::GetCurrentImage aufgerufen, wenn ein NULLpVideoImage-Parameter an diese Memberfunktion übergeben wird. Daher erstellt diese Memberfunktion eine VIDEOINFOHEADER-Struktur und gibt diese zurück, wobei die Informationen in pBufferSize und pSourceRect verwendet werden.

Anforderungen

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

Siehe auch

CBaseControlVideo-Klasse