Uso de funciones de instalación de dispositivos
En esta sección se resumen las funciones de instalación del dispositivo. Mediante las funciones de instalación de dispositivos, el software de instalación puede realizar los siguientes tipos de operaciones:
Instalación de controladores
Controlar códigos DIF.
Administrar conjuntos de información de dispositivos.
Administrar listas de controladores.
Administrar interfaces de dispositivo.
Administrar iconos y otros mapas de bits.
En las tablas siguientes se proporcionan resúmenes de los siguientes tipos de funciones:
Funciones de instalación de controladores
Funciones de información del dispositivo
Funciones de información del controlador
Controladores de instalación de dispositivos
Funciones de personalización de instalación de dispositivos
Funciones de mapa de bits e icono
Funciones de interfaz de dispositivo
Funciones de propiedad device (Windows Vista y versiones posteriores)
Funciones de instalación de controladores
Instala un paquete de controladores especificado que está preinstalado en el almacén de controladores en un dispositivo PnP que está presente en el sistema. (Windows Vista y versiones posteriores de Windows) |
|
Desinstala un dispositivo y quita su nodo de dispositivo (devnode) del sistema. (Windows 7 y versiones posteriores de Windows) |
|
Preinstala un paquete de controladores en el almacén de controladores y, a continuación, instala el paquete de controladores en dispositivos PnP coincidentes que están presentes en el sistema. (Windows Vista y versiones posteriores de Windows) |
|
Quita un paquete de controladores del almacén de controladores. (Windows 10 versión 1703 y versiones posteriores de Windows) |
|
Novedades el paquete de controladores que se instala para los dispositivos PnP coincidentes que están presentes en el sistema. |
|
Revierte el paquete de controladores instalado en un dispositivo especificado al paquete de controladores de copia de seguridad establecido para el dispositivo. (Windows Vista y versiones posteriores de Windows) |
Funciones de información del dispositivo
Nota:
SetupApi no se admite en todas las ediciones de Windows. Cuando sea posible, debe usar las API de nivel inferior, como las disponibles a través de CfgMgr32.dll. Consulte Migración de SetupApi a CfgMgr32 para obtener sugerencias.
Crea un conjunto de información de dispositivo vacío. Este conjunto se puede asociar a un GUID de clase. |
|
Crea un conjunto de información de dispositivo vacío. Este conjunto se puede asociar a un GUID de clase y puede ser para dispositivos en un equipo remoto. |
|
Crea un nuevo elemento de información del dispositivo y lo agrega como un nuevo miembro al conjunto de información del dispositivo especificado. |
|
Recupera información sobre una instancia de dispositivo existente y la agrega al conjunto de información de dispositivo especificado. |
|
Devuelve una estructura de contexto para un elemento de información de dispositivo de un conjunto de información de dispositivo. |
|
Recupera el identificador de instancia de dispositivo asociado a un elemento de información del dispositivo. |
|
Recupera el GUID de clase asociado a un conjunto de información del dispositivo si tiene una clase asociada. |
|
Recupera información asociada a un conjunto de información del dispositivo, incluido el GUID de clase, el identificador de equipo remoto y el nombre del equipo remoto. |
|
Recupera identificadores de las hojas de propiedades de un elemento de información de dispositivo especificado o de la clase de configuración del dispositivo de un conjunto de información de dispositivo especificado. |
|
Devuelve un conjunto de información de dispositivo que contiene todos los dispositivos de una clase especificada. |
|
Devuelve un conjunto de información de dispositivo que contiene todos los dispositivos de una clase especificada en un equipo local o remoto. |
|
Establece el elemento de información del dispositivo especificado para que sea el miembro seleccionado actualmente de un conjunto de información del dispositivo. Normalmente, un asistente para la instalación usa esta función. |
|
Recupera el dispositivo seleccionado actualmente para el conjunto de información del dispositivo especificado. |
|
Registra una instancia de dispositivo recién creada con el administrador de Plug and Play. |
|
Elimina un miembro del conjunto de información del dispositivo especificado. Esta función no elimina el dispositivo real. |
|
Destruye un conjunto de información del dispositivo y libera toda la memoria asociada. |
Funciones de información del controlador
Crea una lista de controladores asociados a una instancia de dispositivo especificada o con la lista de controladores de clase global del conjunto de información del dispositivo. |
|
Enumera los miembros de una lista de información de controladores. |
|
Recupera información detallada para un elemento de información del controlador especificado. |
|
Establece el miembro especificado de una lista de controladores como el controlador seleccionado actualmente. También se puede usar para restablecer la lista de controladores para que no haya ningún controlador seleccionado actualmente. |
|
Recupera el miembro de una lista de controladores que se seleccionó como controlador que se va a instalar. |
|
Cancela una búsqueda de lista de controladores que está actualmente en curso en un subproceso diferente. |
|
Destruye una lista de información del controlador. |
Controladores de instalación de dispositivos
Llama al instalador de clase adecuado y a los coinstaladores registrados, con la solicitud de instalación especificada. |
|
Controlador predeterminado para la solicitud de DIF_PROPERTYCHANGE. Se puede usar para cambiar el estado de un dispositivo instalado. |
|
Registra los coins instaladores específicos del dispositivo enumerados en el archivo INF del dispositivo especificado. Esta función es el controlador predeterminado para DIF_REGISTER_COINSTALLERS. |
|
Controlador predeterminado para la solicitud de DIF_INSTALLDEVICE. |
|
Controlador predeterminado para la solicitud de DIF_INSTALLDEVICEFILES. |
|
Controlador predeterminado para la solicitud de DIF_INSTALLINTERFACES. Instala las interfaces que aparecen en un DDInstall. Sección interfaces de un archivo INF de dispositivo. |
|
Esta función está obsoleta y no se puede usar en ninguna versión de Microsoft Windows. |
|
Controlador predeterminado para la solicitud de DIF_REMOVEDEVICE. |
|
Controlador predeterminado para la solicitud de DIF_UNREMOVE. |
|
Controlador predeterminado para la solicitud de DIF_REGISTERDEVICE. |
|
Controlador predeterminado para la solicitud de DIF_SELECTDEVICE. |
|
Controlador predeterminado para la solicitud de DIF_SELECTBESTCOMPATDRV. |
|
Controlador predeterminado para la solicitud de DIF_SELECTDEVICE. |
Funciones de personalización de instalación de dispositivos
Recupera parámetros de instalación de clase para un conjunto de información de dispositivo o un elemento de información de dispositivo determinado. |
|
Establece o borra los parámetros de instalación de clase para un conjunto de información del dispositivo o un elemento de información de dispositivo determinado. |
|
Recupera los parámetros de instalación del dispositivo para un conjunto de información del dispositivo o un elemento de información de dispositivo determinado. |
|
Establece parámetros de instalación de dispositivos para un conjunto de información de dispositivo o un elemento de información de dispositivo determinado. |
|
Recupera parámetros de instalación para el controlador especificado. |
|
Establece los parámetros de instalación para el controlador especificado. |
Funciones de clase Setup
Devuelve una lista de GUID de clase de instalación que incluye todas las clases instaladas en el sistema. |
|
Devuelve una lista de GUID de clase de instalación que incluye todas las clases instaladas en el sistema local o en un sistema remoto. |
|
Recupera la descripción de clase asociada al GUID de clase de instalación especificado. |
|
Recupera la descripción de una clase de instalación instalada en un equipo local o remoto. |
|
Recupera la clase de un archivo INF de dispositivo especificado. |
|
Recupera los GUID asociados al nombre de clase especificado. Esta lista se basa en qué clases están instaladas actualmente en el sistema. |
|
Recupera los GUID asociados al nombre de clase especificado. Esta lista resultante contiene las clases instaladas actualmente en un equipo local o remoto. |
|
Recupera el nombre de clase asociado al GUID de clase. |
|
Recupera el nombre de clase asociado a un GUID de clase. La clase se puede instalar en un equipo local o remoto. |
|
Instala la sección ClassInstall32 del archivo INF especificado. |
|
Instala un instalador de clase o una clase de interfaz. |
|
Abre la clave del Registro de la clase device setup o una subclave específica de la clase . |
|
Abre la clave del Registro de la clase device setup, la clave del Registro de clase de interfaz de dispositivo o una subclave específica de la clase . Esta función abre la clave especificada en el equipo local o en un equipo remoto. |
Funciones de mapa de bits e icono
Compila una lista de imágenes que contiene mapas de bits para cada clase instalada y devuelve la lista en una estructura de datos. |
|
Compila una lista de imágenes de mapas de bits para cada clase instalada en un equipo local o remoto. |
|
Recupera el índice dentro de la lista de imágenes de clase de una clase especificada. |
|
Recupera el índice del miniicono proporcionado para la clase especificada. |
|
Dibuja el miniicono especificado en la ubicación solicitada. |
|
Carga tanto el icono grande como el miniicono para la clase especificada. |
|
Carga un icono de dispositivo para un dispositivo especificado. (Windows Vista y versiones posteriores de Windows) |
|
Destruye una lista de imágenes de clase. |
Funciones de interfaz de dispositivo
Nota:
SetupApi no se admite en todas las ediciones de Windows. Cuando sea posible, debe usar API de capa inferior como las disponibles a través deCfgMgr32.dll. Consulte Migración de SetupApi a CfgMgr32 para obtener sugerencias.
Registra la funcionalidad del dispositivo (una interfaz de dispositivo) para un dispositivo. |
|
Recupera información sobre una interfaz de dispositivo existente y la agrega al conjunto de información de dispositivo especificado. |
|
Devuelve un alias de la interfaz de dispositivo especificada. |
|
Devuelve un conjunto de información de dispositivo que contiene todos los dispositivos de una clase especificada. |
|
Devuelve un conjunto de información de dispositivo que contiene todos los dispositivos de una clase especificada en un equipo local o remoto. |
|
Devuelve una estructura de contexto para un elemento de interfaz de dispositivo de un conjunto de información del dispositivo. Cada llamada devuelve información sobre una interfaz de dispositivo. Se puede llamar a la función repetidamente para obtener información sobre varias interfaces expuestas por uno o varios dispositivos. |
|
Devuelve detalles sobre una interfaz de dispositivo determinada. |
|
Crea una subclave del Registro para almacenar información sobre una instancia de interfaz de dispositivo y devuelve un identificador a la clave. |
|
Abre la subclave del Registro que usan las aplicaciones y los controladores para almacenar información específica de una instancia de interfaz de dispositivo y devuelve un identificador a la clave. |
|
Elimina la subclave del Registro que usaron las aplicaciones y los controladores para almacenar información específica de una instancia de interfaz de dispositivo. |
|
Es el controlador predeterminado para la solicitud de DIF_INSTALLINTERFACES. Instala las interfaces que aparecen en un DDInstall. Sección interfaces de un archivo INF de dispositivo. |
|
Quita una interfaz de dispositivo registrada del sistema. |
|
Elimina una interfaz de dispositivo de un conjunto de información del dispositivo. |
|
Establece una interfaz de dispositivo especificada como interfaz predeterminada para una clase de dispositivo. |
|
Instala un instalador de clase o una clase de interfaz. |
|
Abre la clave del Registro de clase de instalación de dispositivos , la clave del Registro de clase de interfaz de dispositivo o una subclave específica de la clase . Esta función abre la clave especificada en el equipo local o en un equipo remoto. |
Funciones de propiedad device (Windows Vista y versiones posteriores)
Nota
SetupApi no se admite en todas las ediciones de Windows. Cuando sea posible, debe usar las API de nivel inferior, como las disponibles a través de CfgMgr32.dll. Consulte Migración de SetupApi a CfgMgr32 para obtener sugerencias.
Recupera una propiedad de dispositivo establecida para una clase de configuración de dispositivo o una clase de interfaz de dispositivo. |
|
Recupera una propiedad de clase para una clase de configuración de dispositivo o una clase de interfaz de dispositivo en un equipo local o remoto. |
|
Recupera una matriz de las claves de propiedad del dispositivo que representan las propiedades del dispositivo que se establecen para una clase de configuración de dispositivo o una clase de interfaz de dispositivo. |
|
Recupera una matriz de las claves de propiedad del dispositivo que representan las propiedades del dispositivo que se establecen para una clase de configuración de dispositivo o una clase de interfaz de dispositivo en un equipo local o remoto. |
|
Recupera una propiedad de dispositivo establecida para una interfaz de dispositivo. |
|
Recupera una matriz de claves de propiedad de dispositivo que representan las propiedades del dispositivo que se establecen para una interfaz de dispositivo. |
|
Recupera una propiedad de instancia de dispositivo. |
|
Recupera una matriz de las claves de propiedad del dispositivo que representan las propiedades del dispositivo que se establecen para una instancia de dispositivo. |
|
Establece una propiedad de clase para una clase de configuración de dispositivo o una clase de interfaz de dispositivo. |
|
Establece una propiedad de dispositivo para una clase de configuración de dispositivo o una clase de interfaz de dispositivo en un equipo local o remoto. |
|
Establece una propiedad de dispositivo de una interfaz de dispositivo. |
|
Establece una propiedad de instancia de dispositivo. |
Funciones del Registro
Nota
SetupApi no se admite en todas las ediciones de Windows. Cuando sea posible, debe usar las API de nivel inferior, como las disponibles a través de CfgMgr32.dll. Consulte Migración de SetupApi a CfgMgr32 para obtener sugerencias.
Crea una clave de almacenamiento del Registro para la información de configuración específica del dispositivo y devuelve un identificador a la clave. |
|
Abre una clave de almacenamiento del Registro para la información de configuración específica del dispositivo y devuelve un identificador a la clave. |
|
Elimina las claves del Registro accesibles para el usuario especificadas asociadas a un elemento de información del dispositivo. |
|
Abre la clave del Registro de clase de instalación o una subclave específica de la clase . |
|
Abre la clave del Registro de clase de instalación de dispositivos, la clave del Registro de clase de interfaz de dispositivo o una subclave específica de la clase . Esta función abre la clave especificada en el equipo local o en un equipo remoto. |
|
Crea una subclave del Registro no volátil para almacenar información sobre una instancia de interfaz de dispositivo y devuelve un identificador a la clave. |
|
Abre la subclave del Registro que usan las aplicaciones y los controladores para almacenar información específica de una instancia de interfaz de dispositivo y devuelve un identificador a la clave. |
|
Elimina la subclave del Registro que usaron las aplicaciones y los controladores para almacenar información específica de una instancia de interfaz de dispositivo. |
|
Establece la propiedad de dispositivo Plug and Play especificada. |
|
Recupera la propiedad de dispositivo Plug and Play especificada. |
|
Recupera una propiedad de clase de dispositivo especificada del Registro. |
|
Establece una propiedad de clase de dispositivo especificada en el Registro. |
Otras funciones
Recupera la sección Modelos INF decoradas adecuada que se usará al instalar un dispositivo desde un archivo INF del dispositivo. |
|
Recupera la sección DDInstall adecuada que se usará al instalar un dispositivo desde un archivo INF del dispositivo. |
|
Recupera el nombre de la sección INF DDInstall que instala un dispositivo para un sistema operativo y una arquitectura de procesador especificadas. |
|
Recupera el nombre descriptivo asociado a un identificador de perfil de hardware. |
|
Recupera el nombre descriptivo asociado a un identificador de perfil de hardware en un equipo local o remoto. |
|
Recupera una lista de todos los identificadores de perfil de hardware definidos actualmente. |
|
Recupera una lista de todos los identificadores de perfil de hardware definidos actualmente en un equipo local o remoto. |
|
Reinicia un dispositivo especificado o, si es necesario, inicia todos los dispositivos operados por la misma función y los controladores de filtro que el dispositivo especificado. |