AVStream-Deskriptoren

Ein AVStream-Minidriver beschreibt sich selbst und die filtertypen, die er unterstützt, indem er geschachtelte Deskriptorstrukturen im Aufruf von KsInitializeDriver bereitstellt. Jede Schlüsselkomponente – das Gerät, die Filterfactory und die Stiftfactory – verfügt über einen zugeordneten Deskriptor.

Wie in AVStream-Objekthierarchie gezeigt, ist der Deskriptor der höchsten Ebene für einen AVStream-Minidriver der Gerätedeskriptor , KSDEVICE_DESCRIPTOR.

Im Gerätedeskriptor verweist der FilterDescriptors-Member auf ein Array von KSFILTER_DESCRIPTOR Strukturen, die die Filtertypen beschreiben, die dieses Gerät erstellen kann. AVStream-Clients können KsCreateFilterFactory aufrufen, um dynamisch Filterfactorys hinzuzufügen.

Ein KSFILTER_DESCRIPTOR gibt an, wie viele Pintypen der Filter unterstützt, unter welchen KS-Kategorien der Filter registriert werden soll, und die Topologie des Filters. In jedem Filterdeskriptor stellt der Minitreiber einen Zeiger auf ein Array von KSPIN_DESCRIPTOR_EX Strukturen bereit. Jeder dieser Pindeskriptoren beschreibt einen Pintyp, den dieser Filter instanziieren kann. Sie können zusätzliche Pin-Factorys erstellen, indem Sie KsFilterCreatePinFactory aufrufen.

In der Regel legen AVStream-Minitreiber statische Deskriptortabellen in ihrer Quelle an und rufen KsInitializeDriver auf, um die Einrichtungsvorgänge auszuführen. Weitere Informationen zum Initialisieren des Treibers finden Sie unter Initialisieren eines AVStream Minidrivers.

Es gibt auch andere Deskriptorentypen, z. B. den Knotendeskriptor KSNODE_DESCRIPTOR, der einen bestimmten Topologieknoten beschreibt.

Die Dispatchtabelle ist für jeden der drei Standard-Deskriptortypen gemeinsam. Weitere Informationen finden Sie unter AVStream-Dispatchtabellen.