AVStream-beskrivningar

En AVStream-minidrivrutin beskriver sig själv och de typer av filter den stöder genom att tillhandahålla nästlade beskrivande strukturer i anropet till KsInitializeDriver. Varje nyckelkomponent – enheten, filterfabriken och pin-fabriken – har en associerad beskrivning.

Som visas i AVStream-objekthierarkin är den högsta nivåbeskrivningen för en AVStream-minimejsel enhetsbeskrivningen , KSDEVICE_DESCRIPTOR.

I enhetsbeskrivningen pekar FilterDescriptors-medlemmen på en matris med KSFILTER_DESCRIPTOR strukturer som beskriver vilka typer av filter som den här enheten kan skapa. AVStream-klienter kan anropa KsCreateFilterFactory för att dynamiskt lägga till filterfabriker.

En KSFILTER_DESCRIPTOR anger hur många stifttyper filtret stöder, de KS-kategorier under vilka filtret ska registreras och topologin för filtret. I varje filterbeskrivning ger minidrivrutinen en pekare till en matris av KSPIN_DESCRIPTOR_EX strukturer. Var och en av dessa pin-beskrivningar beskriver en pin-typ som det här filtret kan instansiera. Du kan skapa ytterligare pin-fabriker genom att anropa KsFilterCreatePinFactory.

Vanligtvis lägger AVStream-minidrivrutiner ut statiska deskriptortabeller i källan och anropar KsInitializeDriver för att utföra installationsarbetet. Mer information om hur du initierar drivrutinen finns i Initiera en AVStream Minidriver.

Det finns även andra typer av beskrivningar, till exempel nodbeskrivningen KSNODE_DESCRIPTOR, som beskriver en viss topologinod.

Dispatch-tabellen är gemensam för var och en av de tre huvudbeskrivningstyperna. Se även AVStream Dispatch-tabeller.