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 |