Función SetupDiInstallDriverFiles (setupapi.h)

  • Artículo

La función SetupDiInstallDriverFiles es el controlador predeterminado de la solicitud de instalación de DIF_INSTALLDEVICEFILES .

Sintaxis

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

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo que contiene el elemento de información del dispositivo que representa el dispositivo para el que se van a instalar los archivos. El conjunto de información del dispositivo no debe contener elementos remotos.

[in] DeviceInfoData

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

Valor devuelto

La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.

Comentarios

El autor de la llamada de SetupDiInstallDriverFiles debe ser miembro del grupo Administradores si esta función se usa para instalar archivos. Sin embargo, si esta función se usa para crear una cola de archivos, no es necesaria la pertenencia al grupo Administradores.

Nota Solo un instalador de clase debe llamar a SetupDiInstallDriverFiles y solo en aquellas situaciones en las que el instalador de clase debe realizar operaciones de instalación de archivos de controlador después de que SetupDiInstallDriverFiles complete la operación de instalación de archivos de controlador predeterminada. En tales situaciones, el instalador de clase debe llamar directamente a SetupDiInstallDriverFiles cuando el instalador procesa una solicitud de DIF_INSTALLDEVICEFILES. Para obtener más información sobre cómo llamar al controlador predeterminado, vea Llamar a controladores de código DIF predeterminados.
 
La operación de SetupDiInstallDriverFiles es similar a la función SetupDiInstallDevice . Sin embargo, esta función realiza solo las operaciones de copia de archivos que realiza SetupDiInstallDevice.

Se debe seleccionar un controlador para el conjunto o elemento de información del dispositivo especificado antes de llamar a esta función.

Esta función procesa las entradas CopyFiles, Delfiles y Renfiles en el archivo INF seleccionado.

DeviceInfoSet solo debe contener elementos en el equipo local.

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

SetupDiCallClassInstaller

SetupDiInstallDevice