Freigeben über


CBaseControlWindow.GetMinIdealImageSize-Methode

[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 GetMinIdealImageSize -Methode ruft die minimale ideale Bildgröße ab.

Syntax

HRESULT GetMinIdealImageSize(
   long *pWidth,
   long *pHeight
);

Parameter

pWidth

Zeiger auf die minimale ideale Breite in Pixel.

pHeight

Zeiger auf die minimale ideale Höhe in Pixel.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Verschiedene Renderer haben Leistungseinschränkungen hinsichtlich der Größe der Bilder, die sie anzeigen können. Obwohl sie weiterhin ordnungsgemäß funktionieren sollten, wenn sie angefordert werden, um Bilder anzuzeigen, die größer als das angegebene Maximum sind, können Renderer die minimalen und maximalen idealen Größen über die IVideoWindow-Schnittstelle nominieren. Diese Schnittstelle kann nur aufgerufen werden, wenn das Filterdiagramm angehalten oder ausgeführt wird, da erst dann Ressourcen zugeordnet werden und der Renderer seine Einschränkungen erkennen kann. Wenn keine Einschränkungen vorhanden sind, füllt der Renderer die Parameter pWidth und pHeight mit den nativen Videodimensionen aus und gibt S_FALSE zurück. Wenn Einschränkungen vorhanden sind, werden die eingeschränkte Breite und Höhe eingegeben, und die Memberfunktion gibt S_OK zurück.

Die Dimensionen gelten für die Größe des Zielvideos und nicht für die Gesamtgröße des Fensters. Berücksichtigen Sie also beim Berechnen der Größe des festzulegenden Fensters die aktuellen Fensterstile (z. B. WS_CAPTION und WS_BORDER).

Anforderungen

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

Siehe auch

CBaseControlWindow-Klasse