Zpracování požadavků rozhraní WMI

Všechny ovladače musí nastavit vstupní bod dispečerské tabulky pro rutinu DispatchSystemControl k zpracování požadavků WMI. Pokud se ovladač registruje jako poskytovatel dat WMI, musí zpracovat všechny požadavky WMI. V opačném případě musí ovladač předávat všechny požadavky rozhraní WMI na další nižší ovladač.

Všechny WMI IRPs mají hlavní kód IRP_MJ_SYSTEM_CONTROL a jeden z těchto menších kódů:

• IRP_MN_REGINFO, IRP_MN_REGINFO_EX– Dotazování nebo aktualizace registračních informací ovladače po zavolání funkce IoWMIRegistrationControl.

• IRP_MN_QUERY_ALL_DATA, IRP_MN_QUERY_SINGLE_INSTANCE– Dotazy pro všechny instance nebo jednu instanci daného bloku dat.

• IRP_MN_CHANGE_SINGLE_ITEM, IRP_MN_CHANGE_SINGLE_INSTANCE– požaduje, aby ovladač změnil jednu položku nebo více položek v instanci datového bloku.

• IRP_MN_ENABLE_COLLECTION, IRP_MN_DISABLE_COLLECTION– žádá ovladač, aby začal shromažďovat data pro blok, který ovladač zaregistroval jako nákladný na sběr dat, nebo aby zastavil shromažďování dat pro takový blok.

• IRP_MN_ENABLE_EVENTS, IRP_MN_DISABLE_EVENTS– žádá řidiče, aby začal odesílat oznámení o dané události, pokud k události dojde, když je povolená, nebo aby přestal odesílat oznámení o takové události.

• IRP_MN_EXECUTE_METHOD– požaduje, aby ovladač spustil metodu přidruženou k datovému bloku.

Komponenta režimu jádra WMI odesílá WMI IRP kdykoli po úspěšné registraci ovladače jako poskytovatele dat, obvykle když uživatelský režim žádá o WMI informace pro zařízení ovladače. Pokud se ovladač zaregistruje jako zprostředkovatel dat WMI voláním IoWMIRegistrationControl, musí zpracovat každý další požadavek WMI jedním z následujících způsobů:

• Zavolejte rutinu knihovny WMI v režimu jádra WmiSystemControl. Ovladač může volat WmiSystemControl pro zpracování požadavků týkajících se pouze bloků, které nepoužívají dynamické názvy instancí, a které založí názvy statických instancí na jediném základním řetězci názvu nebo na ID instance zařízení PDO. Další informace naleznete v tématu Volání WmiSystemControl ke zpracování WMI IRP.

• Ve své DispatchSystemControl proceduře zpracovat a dokončit všechny takové požadavky označené ukazatelem na objekt zařízení, který ovladač předal při volání IoWMIRegistrationControl, a předávat další IRP_MJ_SYSTEM_CONTROL požadavky na další nižší ovladač. Další informace naleznete v kapitole Zpracování I/O požadavkových balíčků (IRPs) v rutině DispatchSystemControl.

Pro seznam menších IRP WMI se podívejte na WMI Minor IRPs.