IVMRDeinterlaceControl::SetDeinterlaceMode-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 SetDeinterlaceMode-Methode legt den Deinterlacingmodus für den angegebenen Videodatenstrom fest.
Syntax
HRESULT SetDeinterlaceMode(
[in] DWORD dwStreamID,
[in] LPGUID lpDeinterlaceMode
);
Parameter
[in] dwStreamID
Index des festzulegenden Videostreams. Verwenden Sie zum Festlegen aller Datenströme den Wert 0xFFFFFFFF.
[in] lpDeinterlaceMode
Zeiger auf eine GUID, die den Deinterlacingmodus angibt. Um die Deinterlacing zu deaktivieren, verwenden Sie den Wert GUID_NULL.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:
Rückgabecode | Beschreibung |
---|---|
|
Ungültige Streamnummer. |
|
NULL-Zeigerargument. |
|
Erfolg. |
|
Die VMR befindet sich nicht im Mixermodus. |
Bemerkungen
Wenn die Anwendung den Modus nicht angibt, wird für die VMR standardmäßig der erste Vom Treiber gemeldete Modus verwendet. Wenn die VMR in beiden Fällen den bevorzugten Modus nicht verwenden kann, greift sie auf einen anderen Modus zurück, wie in der IVMRDeinterlaceControl::SetDeinterlacePrefs-Methode angegeben.
Die SetDeinterlaceMode-Methode gilt nur für neue Verbindungen, die mit der VMR hergestellt werden. Einige Deinterlacingmodi erfordern zusätzliche Referenzbeispiele. die genaue Anzahl hängt vom Modus ab. Die VMR ordnet Oberflächen für diese zusätzlichen Beispiele zu. Der Client muss den Deinterlace-Modus festlegen, bevor die Oberflächen zugeordnet wurden. Die Surface-Zuordnung erfolgt nach einer der folgenden Aktionen:
- Anheften von Verbindungen, einschließlich dynamischer Erneutverbindungen
- Dynamische Formatänderungen (der Upstream Filter ruft IPin::ReceiveConnection auf, um ein neues Format anzugeben)
- Auflösungsänderungen
- Überwachen von Änderungen
Anforderungen
Unterstützte Mindestversion (Client) | Windows XP mit SP1 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | strmif.h (include Dshow.h) |
Bibliothek | Strmiids.lib |
Siehe auch
IVMRDeinterlaceControl-Schnittstelle