CBaseControlWindow.GetMaxIdealImageSize-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 GetMaxIdealImageSize -Methode ruft die maximale ideale Bildgröße ab.

Syntax

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

Parameter

pWidth

Zeiger auf die maximale ideale Breite in Pixel.

pHeight

Zeiger auf die maximale ideale Höhe in Pixel.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Verschiedene Renderer haben Leistungsbeschränkungen hinsichtlich der Größe der Bilder, die sie anzeigen können. Obwohl sie weiterhin ordnungsgemäß funktionieren sollten, wenn sie aufgefordert werden, 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

Siehe auch

CBaseControlWindow-Klasse