Vytvoření nového ovladače funkce zařízení

V tomto článku vysvětlujeme, jak pomocí sady Visual Studio začít psát nový ovladač funkce zařízení. Ovladače funkcí zařízení se liší od ovladačů filtru, softwarových ovladačů a ovladačů systému souborů, které probíráme v jiných článcích. Informace o ovladačích funkcí zařízení a jejich rozdílech od jiných typů ovladačů najdete v tématu Co je ovladač?, Výběr modelu ovladačů a uzlů zařízení a zásobníků zařízení.

Začněte tím, že určíte, kde se vaše zařízení vejde do seznamu technologií popsaných v tématu Technologie zařízení a ovladačů. Informace o tom, které modely ovladačů jsou pro vaše zařízení k dispozici, najdete v dokumentaci pro danou konkrétní technologii. Doporučený model ovladačů se liší od jedné technologie po další. U některých technologií doporučuje dokumentace použít rozhraní UMDF (User Mode Driver Framework) nebo rozhraní KMDF (Kernel Mode Driver Framework). V případě jiných technologií vysvětluje dokumentace, jak vytvořit minidriver, který je součástí páru ovladačů. Minidrivery se označují různými názvy, včetně miniport a miniclass.

Určete, které z následujících případů popisuje doporučení modelu ovladače, a postupujte podle těchto kroků:

Případ 1: Dokumentace pro vaši technologii doporučuje UMDF

1. Spusťte Visual Studio.
2. V dialogovém okně Po spuštění zvolte Vytvořit nový projekt nebo vyberte Nový | Projekt z menu Visual Studio Soubor.
3. V pravém podokně dialogového okna Vytvořit nový projekt vyhledejte a vyberte Ovladač uživatelského režimu (UMDF V2).
4. Vyberte Další.
5. Vyplňte pole Název projektu, Umístění a Název řešení a vyberte Vytvořit. Další informace naleznete v tématu Zápis ovladače UMDF na základě šablony.

   Poznámka:

   Při vytváření nového ovladače UMDF musíte vybrat název ovladače, který má 32 znaků nebo méně. Tento limit délky je definován v wdfglobals.h.

6. V tuto chvíli máte projekt ovladače, který implementuje obecný kód vyžadovaný většinou ovladačů UMDF. Teď můžete zadat kód, který je specifický pro vaše zařízení. Informace o rozhraních, která potřebujete implementovat, najdete v dokumentaci ke své technologii.

Případ 2: Dokumentace pro vaši technologii doporučuje službu KMDF.

1. Spusťte Visual Studio.
2. V dialogovém okně spouštěcího systému zvolte Vytvořit nový projekt nebo vyberte Nový | Projekt z nabídky Soubor ve Visual Studiu.
3. V pravém podokně dialogového okna Vytvořit nový projekt vyhledejte a vyberte ovladač režimu jádra (KMDF).
4. Vyberte Další.
5. Vyplňte pole Název projektu, Umístění a Název řešení a vyberte Vytvořit. Další informace najdete v tématu Zápis ovladače KMDF na základě šablony.

   Poznámka:

   Při vytváření nového ovladače KMDF musíte vybrat název ovladače, který má 32 znaků nebo méně. Tento limit délky je definován v wdfglobals.h.

6. V tuto chvíli máte projekt ovladače, který implementuje obecný kód vyžadovaný většinou ovladačů KMDF. Teď můžete zadat kód, který je specifický pro vaše zařízení. Informace o metodách, které potřebujete implementovat, najdete v dokumentaci ke své technologii.

Případ 3: Dokumentace k vaší technologii popisuje model minidriveru

Pokud má vaše technologie zařízení miniport, minitřídu nebo jiný model minidriveru, ověřte, zda Visual Studio obsahuje pro tento model konkrétní šablonu.

1. Spusťte Visual Studio.
2. V dialogovém okně Po spuštění zvolte Vytvořit nový projekt nebo vyberte Nový | Projekt z nabídky Soubor ve Visual Studio.
3. V pravém podokně dialogového okna Vytvořit nový projekt procházejte seznam nainstalovaných šablon a najděte šablonu pro typ ovladače, který potřebujete napsat.
4. Pokud najdete šablonu pro váš typ ovladače, vyberte ji.
5. Vyberte Další.
6. Vyplňte pole Název projektu, Umístění a Název řešení a vyberte Vytvořit.
7. Pokud se vám zobrazí průvodce pro ovladače, projděte tímto průvodcem pro vytvoření projektu ovladače.
8. V tuto chvíli máte projekt ovladače, který implementuje obecný kód vyžadovaný ovladačem. Teď můžete zadat kód, který je specifický pro vaše zařízení. Informace o funkcích, které potřebujete implementovat, najdete v dokumentaci ke své technologii.

Pokud má vaše technologie zařízení model minidriveru a nemůžete najít konkrétní šablonu pro váš typ minidriveru, šablona Modelu ovladačů systému Windows (WDM) bude pravděpodobně vaším výchozím bodem. Pokyny najdete v dokumentaci specifické pro vaši technologii. Ve výjimečných případech můžete pomocí KMDF napsat minidriver, ale obvykle je výchozím bodem WDM.

1. Spusťte Visual Studio.
2. V dialogovém okně Po spuštění zvolte Vytvořit nový projekt nebo vyberte Nový | Projekt z nabídky Soubor ve Visual Studiu.
3. V pravém podokně dialogového okna Vytvořit nový projekt vyhledejte a vyberte Prázdný ovladač WDM.
4. Vyberte Další.
5. Vyplňte pole Název projektu, Umístění a Název řešení a vyberte Vytvořit.
6. V tuto chvíli máte prázdný projekt ovladače WDM. V okně Průzkumníka řešení klikněte pravým tlačítkem na projekt ovladače a zvolte Přidat | Nová položka.
7. V dialogovém okně Přidat novou položku zadejte název souboru .cpp a vyberte Přidat.

   Poznámka:

   Pokud chcete vytvořit soubor .c místo souboru .cpp, zadejte název, který má příponu .c.

8. Informace o funkcích, které potřebujete implementovat, najdete v dokumentaci ke své technologii. Při implementaci a uspořádání funkcí se můžete rozhodnout přidat další soubory .cpp nebo .c.