Declaraciones de la función KMDF del comprobador de controladores estático

Para permitir que SDV compruebe el controlador KMDF, debe declarar cada función de retorno de llamada mediante un tipo de rol de función de retorno de llamada. Los tipos de rol de las funciones de devolución de llamada se definen en los distintos archivos de encabezado de WDF y se incluyen al compilar su controlador con el archivo de encabezado Wdf.h. En la tabla siguiente se muestran los tipos de funciones de rol y las funciones de devolución de llamada de eventos con las que están asociadas.

Debe declarar las funciones de devolución de llamada del controlador antes de las definiciones de función de devolución de llamada. En el siguiente ejemplo se muestra la declaración del tipo de rol de la función para la función de devolución de llamada EvtDriverDeviceAdd. En este ejemplo, la función de devolución de llamada se denomina EvtDriverDeviceAdd.

#include <NTDDK.h>  
#include <wdf.h>
EVT_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd

Si una función callback tiene una declaración de prototipo de función, debe reemplazar el prototipo de función por la declaración de tipo de rol de función. Para obtener más información sobre las declaraciones de tipo de rol de función, vea Using Function Role Type Declarations.

En la tabla siguiente se muestran los tipos de funciones de devolución de llamada y las funciones de devolución de llamada de eventos con las que están asociadas.

Tipos de roles de funciones que permiten varios callbacks

Hay algunos tipos de función de rol que pueden tener varias funciones de callback de eventos asociadas a ellos. Por ejemplo, un controlador podría tener varias funciones de callback EvtTimerFunc o EvtDpcFunc. En la tabla siguiente se muestra el número máximo de devoluciones de llamada compatibles con SDV para cada tipo de rol de función. Aunque no es incorrecto que un controlador tenga más funciones de devolución de llamada de las que se enumeran como máximo en la tabla, dificulta el proceso de comprobación al usar SDV. Para obtener información sobre los cambios que puede que necesite realizar en el archivo Sdv-map.h para dar cabida a las funciones de devolución de llamada adicionales, consulte Puntos de entrada duplicados para un tipo de rol de función.

Tipos de rol de función y colas de E/S

Utilice los siguientes tipos de rol de función al declarar los controladores de solicitudes y las funciones de devolución de llamada que dependen del entorno de KMDF para entregar las solicitudes de E/S al controlador (para el envío secuencial o paralelo). No uses estos tipos de rol de función para las funciones que reenvían manualmente las solicitudes de la cola predeterminada a otras colas (distribución manual). SDV no admite un modelo de memoria que le permita realizar un seguimiento de las solicitudes de una cola a otra.

Para obtener más información sobre las colas de E/S, consulte Creación de colas de E/S.

Tipos de rol de función para las funciones EvtCleanupCallback y EvtDestroyCallback

Debe declarar la función EvtCleanupCallback y EvtDestroyCallback con tipos de rol de función específicos del objeto. SDV requiere estos tipos de roles específicos del objeto para determinar si el controlador está utilizando correctamente la función de devolución de llamada. Use las tablas siguientes para determinar qué tipo de función se va a usar.