IVMRMixerControl::SetOutputRect-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 SetOutputRect -Methode legt die Position dieses Datenstroms innerhalb des Kompositionsrechtecks fest.

Syntax

HRESULT SetOutputRect(
  [in] DWORD                dwStreamID,
  [in] const NORMALIZEDRECT *pRect
);

Parameter

[in] dwStreamID

Gibt den Eingabedatenstrom an.

[in] pRect

Zeiger auf eine NORMALIZEDRECT-Struktur , die die Position des Rechtecks mit Kompositionsraum angibt.

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. Legen Sie beispielsweise links größer als rechts fest, um das Video in x-Richtung zu Spiegel. Wenn Sie ein leeres Rechteck angeben, wird dieser Stream deaktiviert.

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::GetOutputRect

Verwenden des Videomischrenderers