Framework Device (objeto)

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 objeto de dispositivo de marco se expone a los controladores mediante la interfaz IWDFDevice . El objeto de dispositivo del marco es la representación del marco del dispositivo en el sistema. Cada objeto de dispositivo tiene un objeto de controlador primario.

Cuando llega un nuevo dispositivo en el sistema, el marco llama al método IDriverEntry::OnDeviceAdd para notificar al controlador de la llegada y pasa las interfaces IWDFDriver e IWDFDeviceInitialize en la llamada. El controlador puede llamar a métodos de la interfaz IWDFDeviceInitialize para inicializar el nuevo dispositivo. Por ejemplo, el controlador llama al método IWDFDeviceInitialize::RetrieveDevicePropertyStore para consultar la información del dispositivo que se proporciona como parte de la instalación del dispositivo. A continuación, el controlador puede llamar al método IWDFDriver::CreateDevice para configurar y crear el objeto de dispositivo.

Cuando los controladores crean un objeto de dispositivo de marco, pueden registrar sus interfaces IPnpCallback, IPnpCallbackSelfManagedIo, IPnpCallbackHardware, IFileCallbackCleanup e IFileCallbackClose . A continuación, el marco notifica al controlador cuándo se producen eventos de limpieza y cierre de archivos y Plug and Play (PnP) y de administración de energía (PM). Para obtener más información sobre la compatibilidad con PnP y PM, consulte PnP y Administración de energía en controladores basados en UMDF.