Agregar un dispositivo

Advertencia

UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2.

Los ejemplos de UMDF 1 archivados se pueden encontrar en la Windows 11, versión 22H2 : actualización de ejemplos de controladores de mayo de 2022.

Para obtener más información, consulta Introducción con UMDF.

El marco agrega un objeto de dispositivo para cada dispositivo cargado en el proceso de host del controlador. Para agregar el dispositivo, el marco llama al método IDriverEntry::OnDeviceAdd del controlador y pasa las interfaces IWDFDriver e IWDFDeviceInitialize en la llamada. La interfaz IWDFDeviceInitialize proporcionada solo es válida antes de que el controlador llame a IWDFDriver::CreateDevice. El controlador puede llamar a los métodos siguientes de IWDFDeviceInitialize para realizar las siguientes operaciones:

• El controlador llama al método IWDFDeviceInitialize::RetrieveDevicePropertyStore para recuperar la interfaz IWDFNamedPropertyStore para el almacén de propiedades del dispositivo. El controlador puede usar IWDFNamedPropertyStore para recuperar y establecer propiedades para el dispositivo.

• El controlador llama al método IWDFDeviceInitialize::SetLockingConstraint para especificar cómo el marco llama a sus funciones de devolución de llamada.

• El controlador llama al método IWDFDeviceInitialize::SetFilter para habilitar el dispositivo como dispositivo de filtro.

Una vez que el controlador usa IWDFDeviceInitialize para inicializar el dispositivo, el controlador pasa un puntero a IWDFDeviceInitialize en una llamada al método IWDFDriver::CreateDevice para crear un objeto de dispositivo UMDF para el dispositivo. Una vez creado el objeto de dispositivo de marco, el controlador realiza llamadas al método IWDFDevice::CreateIoQueue para crear colas de E/S de lectura y escritura. En estas llamadas IWDFDevice::CreateIoQueue , el controlador debe identificar cómo recibe las solicitudes de la cola de E/S. Para obtener más información, consulte Configuración del modo de distribución para una cola de E/S.