DIF_INSTALLDEVICEFILES

Artículo
06/15/2023

Una solicitud de DIF_INSTALLDEVICEFILES permite que un instalador participe en la copia de los archivos para admitir un dispositivo o para crear una lista de los archivos de un dispositivo. Los archivos de dispositivo incluyen archivos para el controlador seleccionado, las interfaces de dispositivo y los coinsercionadores.

Cuándo se envió

Los componentes de instalación de dispositivos proporcionados por el sistema envían esta solicitud DIF por diversos motivos. Algunos componentes de instalación de dispositivos envían esta solicitud DIF antes de DIF_REGISTER_COINSTALLERS, DIF_INSTALLINTERFACES y DIF_INSTALL_DEVICE para asegurarse de que todos los archivos pertinentes se pueden copiar antes de continuar con la instalación. Algunos componentes de instalación de dispositivos omiten esta solicitud DIF y esperan que los archivos se copien durante el control de esas tres solicitudes DIF. Además, algunos componentes de instalación de dispositivos envían esta solicitud DIF para recuperar la lista de los archivos asociados a un dispositivo.

Quién controla

Coinserción de clase	Puede controlar
Instalador conjunta del dispositivo	No controla
Instalador de clase	Puede controlar

Entrada del instalador

DeviceInfoSet
Proporciona un identificador al conjunto de información del dispositivo que contiene el dispositivo cuyos archivos auxiliares se van a copiar.

DeviceInfoData
Proporciona un puntero a una estructura de SP_DEVINFO_DATA que identifica el dispositivo en el conjunto de información del dispositivo.

Parámetros de instalación de dispositivos
Hay parámetros de instalación de dispositivos (SP_DEVINSTALL_PARAMS) asociados a DeviceInfoData.

Si se establece la marca DI_NOVCP, los parámetros de instalación del dispositivo contienen un identificador FileQueue válido y los instaladores que controlan esta solicitud DIF agregan sus operaciones de archivo a esta cola y no confirman la cola.

Parámetros de instalación de clases
Ninguno

Salida del instalador

Parámetros de instalación de dispositivos
Un instalador puede modificar FileQueue, si hay uno.

Valor devuelto del instalador

Un co-instalador puede devolver NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED o un código de error win32.

Si un instalador de clase controla correctamente esta solicitud y SetupDiCallClassInstaller debe llamar posteriormente al controlador predeterminado, el instalador de clase devuelve ERROR_DI_DO_DEFAULT.

Si el instalador de clase controla correctamente esta solicitud, incluida la llamada directa al controlador predeterminado, el instalador de clase debe devolver NO_ERROR y SetupDiCallClassInstaller no volverá a llamar al controlador predeterminado.

Nota El instalador de clase puede llamar directamente al controlador predeterminado, pero el instalador de clase nunca debe intentar reemplazar las operaciones del controlador predeterminado.

Para obtener más información sobre cómo llamar al controlador predeterminado, vea Llamar a controladores de código DIF predeterminados.

Si el instalador de clase encuentra un error, el instalador debe devolver un código de error win32 adecuado y SetupDiCallClassInstaller no llamará posteriormente al controlador predeterminado.

Controlador de código DIF predeterminado

SetupDiInstallDriverFiles

Operación del instalador

En respuesta a una solicitud de DIF_INSTALLDEVICEFILES un instalador especifica las operaciones de archivo necesarias. Por ejemplo, un instalador puede especificar un archivo adicional que se va a copiar que es necesario para la instalación del dispositivo. Si se establece la marca DI_NOVCP, un instalador especifica las operaciones de archivo agregándolas a FileQueue en los parámetros de instalación del dispositivo. Consulte la Microsoft Windows SDK para obtener información sobre cómo usar colas de archivos y para obtener páginas de referencia en funciones de puesta en cola de archivos, como SetupInstallFilesFromInfSection.

Si esta solicitud DIF se envía durante la instalación del dispositivo y el instalador devuelve un código de error de Microsoft Win32, Windows detiene la instalación.

Si un componente de instalación de dispositivos proporcionado por el sistema envía esta solicitud DIF para recuperar una lista de los archivos asociados a un dispositivo, el componente recupera la cola de archivos, pero no confirma la cola.

Para obtener más información sobre los códigos DIF, consulte Control de códigos DIF.

Requisitos

Versión	Compatible con Microsoft Windows 2000 y versiones posteriores de Windows.
Encabezado	Setupapi.h (incluya Setupapi.h)

Consulte también