Función SetupDiInstallDeviceInterfaces (setupapi.h)

  • Artículo

La función SetupDiInstallDeviceInterfaces es el controlador predeterminado para la solicitud de instalación de DIF_INSTALLINTERFACES .

Sintaxis

WINSETUPAPI BOOL SetupDiInstallDeviceInterfaces(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Parámetros

[in] DeviceInfoSet

Puntero al conjunto de información del dispositivo que contiene un elemento de información del dispositivo que representa el dispositivo para el que se van a instalar las interfaces. El conjunto de información del dispositivo debe contener solo elementos para el sistema local.

[in] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet.

Valor devuelto

SetupDiInstallDeviceInterfaces devuelve TRUE si la función se completó sin error. Si la función se completó con un error, se devuelve FALSE y se puede recuperar el código de error llamando a GetLastError.

Comentarios

SetupDiInstallDeviceInterfaces procesa cada entrada AddInterface en DDInstall. La sección Interfaces de un archivo INF de dispositivo y crea cada interfaz mediante una llamada a SetupDiCreateDeviceInterface.

El autor de la llamada de SetupDiInstallDeviceInterfaces debe ser miembro del grupo Administradores.

Nota Solo un instalador de clase debe llamar a SetupDiInstallDeviceInterfaces y solo en aquellas situaciones en las que el instalador de clase debe realizar operaciones de instalación de la interfaz de dispositivo después de que SetupDiInstallDeviceInterfaces complete la operación de instalación de la interfaz de dispositivo predeterminada. En tales situaciones, el instalador de clase debe llamar directamente a SetupDiInstallDeviceInterfaces cuando el instalador procesa una solicitud de DIF_INSTALLINTERFACES. Para obtener más información sobre cómo llamar al controlador predeterminado, vea Llamar a controladores de código DIF predeterminados.
 
Para obtener información sobre el formato de archivo INF, vea INF File Sections and Directive.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado setupapi.h (incluya Setupapi.h)
Library Setupapi.lib
Archivo DLL Setupapi.dll

Consulte también

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface