Freigeben über


IMixerPinConfig::SetRelativePosition-Methode (mpconfig.h)

[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 SetRelativePosition -Methode legt die Position des Datenstroms im Anzeigefenster fest.

Syntax

HRESULT SetRelativePosition(
  [in] DWORD dwLeft,
  [in] DWORD dwTop,
  [in] DWORD dwRight,
  [in] DWORD dwBottom
);

Parameter

[in] dwLeft

Wert, der die x-Koordinate in der oberen linken Ecke des Anzeigefensters angibt.

[in] dwTop

Wert, der die y-Koordinate in der oberen linken Ecke des Anzeigefensters angibt.

[in] dwRight

Wert, der die x-Koordinate in der unteren rechten Ecke des Anzeigefensters angibt.

[in] dwBottom

Wert, der die y-Koordinate in der unteren rechten Ecke des Anzeigefensters angibt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:

Rückgabecode Beschreibung
E_INVALIDARG
Koordinaten liegen nicht im Bereich {0, 0, 10.000, 10.000}.
S_OK
Erfolg.

Bemerkungen

Diese Methode setzt die Fensterkoordinaten {0, 0, 10.000, 10.000} voraus. Wenn Ihr Videostream daher im unteren rechten Viertel des Anzeigefensters gerendert werden soll, rufen Sie diese Methode mit den Parametern {5.000, 5.000, 10.000, 10.000} auf.

Hinweis Werte größer als 10.000 sind ungültig und verursachen einen Fehler.
 

Anforderungen

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

Siehe auch

Fehler- und Erfolgscodes

IMixerPinConfig-Schnittstelle

IMixerPinConfig::GetRelativePosition