Descripteurs AVStream

Un minidriver AVStream décrit lui-même et les types de filtre qu’il prend en charge en fournissant des structures de descripteur imbriquées dans l’appel à KsInitializeDriver. Chaque composant clé (l’appareil, la fabrique de filtres et la fabrique de broches ) a un descripteur associé.

Comme indiqué dans la hiérarchie d’objets AVStream, le descripteur de niveau le plus élevé pour un minidriver AVStream est le descripteur d’appareil, KSDEVICE_DESCRIPTOR.

Dans le descripteur d’appareil, le membre FilterDescriptors pointe vers un tableau de structures KSFILTER_DESCRIPTOR qui décrivent les types de filtres que cet appareil peut créer. Les clients AVStream peuvent appeler KsCreateFilterFactory pour ajouter dynamiquement des fabriques de filtres.

Un KSFILTER_DESCRIPTOR indique le nombre de types d’épingles pris en charge par le filtre, les catégories KS sous lesquelles le filtre doit être inscrit et la topologie du filtre. À l’intérieur de chaque descripteur de filtre, le minidriver fournit un pointeur vers un tableau de structures KSPIN_DESCRIPTOR_EX . Chacun de ces descripteurs de broche décrit un type de broche que ce filtre peut instancier. Vous pouvez créer des usines de connecteurs supplémentaires en appelant KsFilterCreatePinFactory.

En règle générale, les minidrivers AVStream mettent en place des tables de descripteur statiques dans leur source et appellent KsInitializeDriver pour effectuer le travail d’installation. Pour plus d’informations sur l’initialisation de votre pilote, consultez Initialisation d’un minidriver AVStream.

Il existe également d’autres types de descripteurs, tels que le descripteur de nœud KSNODE_DESCRIPTOR, qui décrit un nœud de topologie donné.

La table de répartition est commune aux trois principaux types de descripteurs. Consultez les tables de répartition AVStream.