Freigeben über


AMOVIESETUP_FILTER-Struktur

[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 AMOVIESETUP_FILTER-Struktur enthält Informationen zum Registrieren eines Filters.

Syntax

typedef struct _AMOVIESETUP_FILTER {
  const  CLSID           *clsID;
  const  WCHAR           *strName;
  DWORD                  dwMerit;
  UINT                   nPins;
  const  AMOVIESETUP_PIN *lpPin;
} AMOVIESETUP_FILTER, *PAMOVIESETUP_FILTER, *FAR LPAMOVIESETUP_FILTER;

Member

Clsid

Klassenbezeichner des Filters.

strName

Name des Filters.

dwMerit

Filterverdienst. Wird von der IGraphBuilder-Schnittstelle beim Erstellen eines Filtergraphen verwendet. Eine Liste der Verdienstwerte finden Sie unter Merit.

nPins

Anzahl der Elemente im lpPin-Array . Wenn lpPinNULL ist, legen Sie dieses Element auf 0 fest.

lpPin

Zeiger auf ein Array von AMOVIESETUP_PIN Strukturen der Größe nPins. Jedes Element dieses Arrays beschreibt eine Stecknadel am Filter.

Bemerkungen

Informationen zur Verwendung dieser Struktur finden Sie unter Registrieren von DirectShow-Filtern. Verwenden Sie diese Struktur nur für Filter, die in der Standardfilterkategorie (CLSID_LegacyAmFilterCategory) registriert sind. Um einen Filter in einer anderen Kategorie zu registrieren, verwenden Sie die IFilterMapper2::RegisterFilter-Methode , wie unter Implementieren von DllRegisterServer beschrieben.

Hinweis

Die Headerdatei combase.h wird mit den DirectShow-Basisklassen bereitgestellt.

Anforderungen

Anforderung Wert
Header
Combase.h (Einschließen von Streams.h)

Siehe auch

DirectShow-Strukturen