Crear un nuevo controlador de software

En este tema se explica cómo usar Visual Studio para empezar a escribir un nuevo controlador de software. Los controladores de software son diferentes de los controladores de funciones del dispositivo, los controladores de filtro y los controladores del sistema de archivos, que tratamos en otros temas. Para obtener más información sobre los controladores de software y cómo difieren de otros tipos de controladores, vea ¿Qué es un controlador? y Elegir un modelo de controlador.

Para comenzar, primero determine qué modelo de controlador es adecuado para el controlador de software. Las tres opciones son el marco del controlador de modo kernel (KMDF), el modelo de controlador NT heredado y el modelo de controlador de Windows (WDM). Para obtener ayuda para determinar qué modelo es mejor para usted, consulte Elección de un modelo de controlador.

Caso 1: Quiere usar KMDF

1. En Visual Studio, en el menú Archivo , elija Nuevo | Proyecto.
2. En el cuadro de diálogo Nuevo proyecto, en el panel izquierdo, busque y seleccione WDF.
3. En el panel central, seleccione Controlador de modo kernel (KMDF) .
4. Rellene los cuadros Nombre y Ubicación y seleccione Aceptar. Para obtener más información, consulte Escritura de un controlador KMDF basado en una plantilla.

   Nota

   Al crear un nuevo controlador KMDF, debe seleccionar un nombre de controlador con 32 caracteres o menos. Este límite de longitud se define en wdfglobals.h.

5. En este momento, tiene un proyecto de controlador que implementa el código general requerido por la mayoría de los controladores kmdf. Ahora puede proporcionar el código específico del controlador de software.

Caso 2: Desea usar el modelo NT heredado

1. En Visual Studio, en el menú Archivo , elija Nuevo | Proyecto.

2. En Visual Studio, en el cuadro de diálogo Nuevo proyecto, en Controlador de Windows, seleccione WDM | Controlador WDM vacío.

   Nota

   No va a escribir un controlador WDM, pero necesita la plantilla Controlador WDM vacío .

3. Rellene los cuadros Nombre y Ubicación y seleccione Aceptar.

4. En este momento, tiene un proyecto de controlador WDM vacío. En la ventana Explorador de soluciones, seleccione y mantenga presionado (o haga clic con el botón derecho) en el proyecto de controlador y elija Agregar | Nuevo elemento.

5. En el cuadro de diálogo Agregar nuevo elemento, seleccione Archivo de C++ (.cpp), escriba un nombre para el archivo y seleccione Aceptar.

   Nota

   Si desea crear un archivo .c en lugar de un archivo .cpp, escriba un nombre que tenga la extensión .c .

6. Incluya ntddk.h.

7. Implemente las funciones necesarias para el controlador de software. A medida que implemente y organice las funciones, puede decidir agregar archivos de encabezado y archivos .cpp o .c adicionales.

Caso 3: Quiere usar WDM

Es muy poco probable que quiera usar WDM para un controlador de software. Pero si lo hace, siga estos pasos.

1. En Visual Studio, en el menú Archivo , elija Nuevo | Proyecto.

2. En Visual Studio, en el cuadro de diálogo Nuevo proyecto, en Controlador de Windows, seleccione WDM.

3. Rellene los cuadros Nombre y Ubicación y seleccione Aceptar.

4. En este momento, tiene un proyecto de controlador WDM vacío. En la ventana Explorador de soluciones, seleccione y mantenga presionado (o haga clic con el botón derecho) en el proyecto de controlador y elija Agregar | Nuevo elemento.

5. En el cuadro de diálogo Agregar nuevo elemento, seleccione Archivo de C++ (.cpp), escriba un nombre para el archivo y seleccione Aceptar.

   Nota

   Si desea crear un archivo .c en lugar de un archivo .cpp, escriba un nombre que tenga la extensión .c .

6. Incluya wdm.h.

7. Implemente las funciones necesarias para el controlador de software. A medida que implemente y organice las funciones, puede decidir agregar archivos de encabezado y archivos .cpp o .c adicionales.