Freigeben über


IOverlay::GetClipList-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 GetClipList -Methode ruft die Beschneidungsliste ab.

Syntax

HRESULT GetClipList(
  [out] RECT    *pSourceRect,
  [in]  RECT    *pDestinationRect,
  [out] RGNDATA **ppRgnData
);

Parameter

[out] pSourceRect

Zeiger auf das umgebende Clientrechteck.

[in] pDestinationRect

Zeiger auf das Zielrechteck.

[out] ppRgnData

Adresse eines Zeigers auf den Header und Daten, die den Clipping beschreiben. Wenn dies erfolgreich ist, geben Sie den zugeordneten Arbeitsspeicher frei, indem Sie CoTaskMemFree aufrufen.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Wenn die Methode fehlschlägt, wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Die IOverlay-Implementierung weist den Arbeitsspeicher für die Beschneidungsrechtecke zu, da die Länge variieren kann. Der Filter, der diese Methode aufruft, sollte den Arbeitsspeicher (mit CoTaskMemFree) freigeben, wenn er damit fertig ist.

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 strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IOverlay-Schnittstelle