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
E_INVALIDARG
Ungültige Streamnummer.
E_POINTER
NULL-Zeigerargument.
S_OK
Erfolg.
VFW_E_VMR_NOT_IN_MIXER_MODE
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

Fehler- und Erfolgscodes

IVMRDeinterlaceControl-Schnittstelle

IVMRDeinterlaceControl::GetDeinterlaceMode

Verwenden des Videomischrenderers