Inicializace miniportového ovladače

Jakmile bude síťové zařízení k dispozici, systém načte ovladač miniportu NDIS pro správu zařízení (pokud ovladač ještě není načten). Každý ovladač miniportu musí poskytovat funkci DriverEntry. Systém volá DriverEntry po načtení ovladače. DriverEntry registruje charakteristiky miniportového ovladače pomocí NDIS (včetně podporované verze NDIS a vstupních bodů ovladače).

Systém předá dva argumenty DriverEntry:

• Ukazatel na objekt ovladače, který byl vytvořen vstupně-výstupním systémem.

• Ukazatel na cestu registru, která určuje, kde jsou uloženy parametry specifické pro ovladače.

V DriverEntrypředávají ovladače miniportu oba tyto ukazatele ve volání funkce NdisMRegisterMiniportDriver. Ovladače miniportu exportují sadu standardních funkcí MiniportXxx uložením vstupních bodů do struktury NDIS_MINIPORT_DRIVER_CHARACTERISTICS a předáním této struktury NdisMRegisterMiniportDriver.

DriverEntry pro ovladače miniportu vrátí hodnotu vrácenou voláním NdisMRegisterMiniportDriver.

Miniport ovladač také provádí jakoukoli další inicializaci specifickou pro miniport, kterou vyžaduje v DriverEntry. Ovladač provádí inicializaci specifickou pro adaptéry ve funkci MiniportInitializeEx. Další informace o inicializaci adaptéru naleznete v tématu Inicializace adaptéru.

DriverEntry může přidělit strukturu NDIS_MINIPORT_DRIVER_CHARACTERISTICS v zásobníku, protože knihovna NDIS zkopíruje příslušné informace do vlastního úložiště. DriverEntry by měla vynulovat paměť pro tuto strukturu s NdisZeroMemory před nastavením všech hodnot zadaných ovladačem v jejích členech. Členové MajorNdisVersion a MinorNdisVersion musí obsahovat hlavní a vedlejší verze NDIS, které ovladač podporuje. V každém členu XxxHandler struktury charakteristik musí DriverEntry nastavit vstupní bod funkce MiniportXxx dodané ovladačem, nebo člen musí být NULL.

Aby mohl ovladač miniportu konfigurovat volitelné služby, NDIS volá funkci MiniportSetOptions v rámci volání ovladače miniportu na NdisMRegisterMiniportDriver. Další informace o volitelných službách naleznete v tématu Konfigurace volitelných služeb miniportu ovladačů.

Ovladače, které volají NdisMRegisterMiniportDriver, musí být připraveny na to, že kdykoli po vrácení DriverEntry může dojít k volání jejich funkcí MiniportInitializeEx. Takový ovladač musí mít dostatek informací o instalaci a konfiguraci uložených v registru nebo musí být tyto informace dostupné z volání funkce NdisXxx, která je specifická pro typ sběrnice, aby mohly být nastaveny prostředky specifické pro síťové rozhraní, které ovladač potřebuje k provádění síťových I/O operací.

Ovladač miniportu musí nakonec volat NdisMDeregisterMiniportDriver, aby uvolnil prostředky, které alokoval voláním NdisMRegisterMiniportDriver. Pokud inicializace ovladače selže poté, co volání NdisMRegisterMiniportDriver bylo úspěšné, ovladač může zavolat NdisMDeregisterMiniportDriver zevnitř DriverEntry. V opačném případě musí ovladač miniportu uvolnit prostředky specifické pro ovladače, které přiděluje ve své funkci MiniportDriverUnload. Jinými slovy, pokud NdisMRegisterMiniportDriver nevrací NDIS_STATUS_SUCCESS, DriverEntry musí uvolnit všechny prostředky, které přidělil, než vrátí řízení. Pokud k tomu dojde, ovladač se nenačte. Další informace naleznete v části Uvolnění ovladače miniportu.