IBasicVideo2::GetPreferredAspectRatio-Methode (control.h)

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 GetPreferredAspectRatio -Methode ruft das bevorzugte Seitenverhältnis ab.

Syntax

HRESULT GetPreferredAspectRatio(
  [out] long *plAspectX,
  [out] long *plAspectY
);

Parameter

[out] plAspectX

Zeiger auf einen Wert, der das Seitenverhältnis der x-Achse angibt.

[out] plAspectY

Zeiger auf einen Wert, der das Seitenverhältnis der y-Achse angibt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
S_OK	Erfolg.
E_INVALIDARG	Einer oder beide Parameter sind ungültig.
E_NOINTERFACE	Der Renderer implementiert IBasicVideo2 nicht.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	control.h (include Dshow.h)
Bibliothek	Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IBasicVideo2-Schnittstelle

Freigeben über