IVMRDeinterlaceControl::GetNumberOfDeinterlaceModes-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 GetNumberOfDeinterlaceModes-Methode ruft die Deinterlacingmodi ab, die der VMR für das angegebene Videoformat zur Verfügung stehen.

Syntax

HRESULT GetNumberOfDeinterlaceModes(
  [in]      VMRVideoDesc *lpVideoDescription,
  [in, out] LPDWORD      lpdwNumDeinterlaceModes,
  [out]     LPGUID       lpDeinterlaceModes
);

Parameter

[in] lpVideoDescription

Zeiger auf eine VMRVideoDesc-Struktur , die das Video beschreibt.

[in, out] lpdwNumDeinterlaceModes

Zeiger auf einen DWORD-Wert . Bei der Eingabe gibt dieser Wert die Größe des Arrays an, das in lpDeinterlaceModes angegeben ist. Bei der Ausgabe empfängt es die Anzahl von GUIDs, die die Methode in das Array kopiert hat.

[out] lpDeinterlaceModes

Adresse eines vom Aufrufer zugeordneten Arrays. Die -Methode füllt das Array mit GUID-Werten aus. Um die erforderliche Größe des Arrays zu bestimmen, legen Sie diesen Parameter auf NULL fest, und überprüfen Sie den in lpdwNumDeinterlaceModes zurückgegebenen Wert.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:

Rückgabecode Beschreibung
E_POINTER
NULL-Zeigerargument.
S_OK
Erfolg
VFW_E_VMR_NOT_IN_MIXER_MODE
Die VMR befindet sich nicht im Mixermodus.
VFW_E_DDRAW_CAPS_NOT_SUITABLE
Die Video-Karte unterstützt keine Hardwaredeinterlacing.

Bemerkungen

Diese Methode gibt ein Array von GUIDs zurück, wobei jede GUID einen Deinterlacingmodus darstellt, der in der Hardware vom Grafikgerätetreiber unterstützt wird. Das Array ist nach Qualität sortiert, sodass der erste Eintrag die beste Qualität darstellt, der zweite Eintrag die nächstbeste Qualität darstellt usw.

Alle Treiber müssen den folgenden Modus unterstützen:

GUID Beschreibung
DXVA_DeinterlaceBobDevice Bob-Modus
 

Treiber können zusätzliche Modi unterstützen und sollten ihre eigenen GUIDs definieren, um sie zu identifizieren. Rufen Sie für jeden zurückgegebenen Modus die IVMRDeinterlaceControl::GetDeinterlaceModeCaps-Methode auf, um Informationen zu diesem Modus abzurufen.

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

Verwenden des Videomischrenderers