Inicializace minidriveru AVStream

Minidriver AVStream, který sám nezpracovává inicializaci zařízení, volá KsInitializeDriver z rutiny DriverEntry minidriveru. KsInitializeDriver inicializuje objekt ovladače AVStream, včetně zpracování požadavků IRP, zpráv pro přidání zařízení PnP a odinstalování.

Při volání KsInitializeDriver, minidriver předá ukazatel na objekt ovladače, aby inicializoval ukazatel na cestu registru a volitelně objekt popisovače zařízení. Všimněte si, že předání objektu KSDEVICE_DESCRIPTOR není povinné. Pokud minidriver předává popisovač zařízení, AVStream vytvoří zařízení se zadanými vlastnostmi při čase AddDevice.

Objekt popisovače zařízení obsahuje ukazatel na strukturu KSDEVICE_DISPATCH a také pole popisovačů filtru. Zadejte KSFILTER_DESCRIPTOR pro každý typ filtru, který minidriver podporuje. Když minidriver volá KsInitializeDriver, AVStream vytvoří objekt továrny filtrů pro každý typ filtru vystavený minidriverem. Jednotlivé filtry jsou poté instancovány továrnou na filtry po přijetí vytvoření IRP pro přidruženou položku. Každý popisovač filtru obsahuje ukazatel na pole KSPIN_DESCRIPTOR_EX objektů. AVStream vytvoří objekt pro připnutí pro příslušný filtr pro každý typ připínáčku, který minidriver zveřejňuje prostřednictvím tohoto filtru.

Při navázání připojení k danému typu pinu ve filtru vytvoří továrna pinů AVStream objekt pinu. Všimněte si, že každý filtr musí mít alespoň jeden pin. Minidriver používá člen InstancesNecessary KSPIN_DESCRIPTOR_EX k identifikaci počtu instancí tohoto typu pinu, které jsou nezbytné pro správné fungování filtru. Podobně může minidriver nastavit maximální počet pinů, které může továrna pro připnutí instancovat pomocí InstancesPossible člena této struktury.

AVStream podporuje dva typy zpracování: zpracování zaměřené na filtr a zpracování zaměřené na pin. Při rozložení popisovačů se rozhodněte, jaký typ zpracování bude každý typ filtru provádět.

Instalace minidriveru AVStream

Minidriver AVStream musí mít soubor INF, který systém používá k instalaci ovladače. Soubor AVStream INF je založen na společném formátu INF, který je popsán v části Vytvoření souboru INF. Můžete také odkazovat na soubory INF dodané s AVStream vzorovými ovladači v sadě Windows Driver Kit (WDK). Mějte na paměti následující pokyny specifické pro AVStream.

Pokud píšete minidriver pro nadřazené zařízení, část AddReg souboru INF by měla obsahovat:

[ParentName.AddReg]
HKR,"ENUM\[DeviceName]",pnpid,,"[string]"

Pokud píšete minidriver pro podřízenou jednotku, část AddReg by měla obsahovat:

[Manufacturer]
...=ChildName
[ChildName]
...=ChildName.Device,AVStream\[string]

Všimněte si, že "AVStream" by byl "Stream" pro ovladač třídy streamu.

U všech minidriverů AVStream musí referenční řetězec specifický pro filtr v souboru INF odpovídat členu ReferenceGuidstruktury KSFILTER_DESCRIPTOR .

Další informace o popisovači naleznete v tématu POPISOVAČE AVStream.