Freigeben über


IMixerPinConfig::GetRelativePosition-Methode (mpconfig.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 GetRelativePosition -Methode ruft die Position des Datenstroms im Anzeigefenster ab.

Syntax

HRESULT GetRelativePosition(
  [out] DWORD *pdwLeft,
  [out] DWORD *pdwTop,
  [out] DWORD *pdwRight,
  [out] DWORD *pdwBottom
);

Parameter

[out] pdwLeft

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

[out] pdwTop

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

[out] pdwRight

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

[out] pdwBottom

Zeiger auf einen 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, die nicht im Bereich {0, 0, 10.000, 10.000} liegen.
S_OK
Erfolg.

Hinweise

Bei dieser Methode wird von Fensterkoordinaten {0, 0, 10.000, 10.000} ausgegangen. Wenn der Videodatenstrom im unteren rechten Viertel des Anzeigefensters gerendert wird, würde diese Methode {5.000, 5.000, 10.000, 10.000} zurückgeben.

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 mpconfig.h
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IMixerPinConfig-Schnittstelle

IMixerPinConfig::SetRelativePosition