IVMRMixerControl::GetOutputRect-Methode (strmif.h)

[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 GetOutputRect -Methode ruft die Position des Videorechtecks dieses Streams innerhalb des Kompositionsrechtecks ab.

Syntax

HRESULT GetOutputRect(
  [in]  DWORD          dwStreamID,
  [out] NORMALIZEDRECT *pRect
);

Parameter

[in] dwStreamID

Gibt den Eingabedatenstrom an.

[out] pRect

Zeiger auf eine NORMALIZEDRECT-Struktur , die das Zielrechteck im Kompositionsbereich empfängt.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Rückgabecode Beschreibung
E_POINTER
pRect ist ungültig.
VFW_E_NOT_CONNECTED
Der Pin ist nicht verbunden.

Hinweise

Da dieses Rechteck im Kompositionsraum vorhanden ist, gibt es kein "ungültiges" Rechteck. Wenn beispielsweise links größer als rechts ist, bedeutet dies, dass das Video in x-Richtung gespiegelt wird. Ein leeres Rechteck deaktiviert diesen Stream.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IVMRMixerControl-Schnittstelle

IVMRMixerControl::SetOutputRect

Verwenden des Videomischrenderers