IVideoWindow::SetWindowPosition-Methode (control.h)

  • Artikel

[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 SetWindowPosition -Methode legt die Position des Videofensters fest.

Syntax

HRESULT SetWindowPosition(
  [in] long Left,
  [in] long Top,
  [in] long Width,
  [in] long Height
);

Parameter

[in] Left

Die x-Koordinate in Pixel.

[in] Top

Die y-Koordinate in Pixel.

[in] Width

Die Breite in Pixel.

[in] Height

Die Höhe in Pixel.

Rückgabewert

Folgende Rückgabewerte sind möglich:

Rückgabecode Beschreibung
E_INVALIDARG
 Ungültiges Argument.
S_OK
 Erfolg.
VFW_E_NOT_CONNECTED
 Der Videorendererfilter ist nicht verbunden.

Hinweise

Diese Methode hat die gleiche Auswirkung wie das Aufrufen der Methoden IVideoWindow::p ut_Left, IVideoWindow::p ut_Top, IVideoWindow::p ut_Width und IVideoWindow::p ut_Height .

Wenn die Größe des Fensters auf die angegebenen Dimensionen nicht geändert werden kann, ändert diese Methode die Größe und Position des Fensters, um das Fenster anzupassen. Rufen Sie die IVideoWindow::GetWindowPosition-Methode auf, um das Ergebnis zu bestimmen.

Anforderungen

Anforderung Wert
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

Weitere Informationen

Fehler- und Erfolgscodes

IVideoWindow-Schnittstelle