DIF_INSTALLINTERFACES
Una solicitud de DIF_INSTALLINTERFACES permite que un instalador participe en el registro de las interfaces de dispositivo de un dispositivo.
Cuándo se envió
Después de registrar los coinstaladores de dispositivo, pero antes de completar la instalación del dispositivo.
Quién controla
Co-instalador de clase |
Puede controlar |
Instalador co-instalador del dispositivo |
Puede controlar |
Instalador de clase |
Puede controlar |
Entrada del instalador
DeviceInfoSet
Proporciona un identificador al conjunto de información del dispositivo que contiene el dispositivo.
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.
Parámetros de instalación de clases
Ninguno
Salida del instalador
Parámetros de instalación de dispositivos
Un instalador puede modificar los parámetros de instalación del dispositivo, pero no normalmente para esta solicitud DIF.
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
SetupDiInstallDeviceInterfaces
Operación del instalador
En respuesta a una solicitud de DIF_INSTALLINTERFACES un instalador puede registrar una interfaz de dispositivo mediante programación en lugar de tener la interfaz registrada a través del archivo INF. Normalmente, los instaladores proporcionados por el proveedor no controlan esta solicitud DIF.
A menos que se establezca la marca DI_NOFILECOPY, un instalador que controle esta solicitud DIF debe copiar los archivos necesarios para las interfaces de dispositivo.
Si la marca de DI_NOFILECOPY está desactivada, pero se establece la marca DI_NOVCP, el instalador debe poner en cola las operaciones de archivo en la cola de archivos proporcionada, pero no debe confirmar la cola.
Si un instalador registra una interfaz de dispositivo, un componente en modo kernel para el dispositivo (por ejemplo, un controlador) debe llamar a IoSetDeviceInterfaceState para habilitar la interfaz.
Si el instalador devuelve un código de error win32, Windows detiene la instalación.
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 (incluir Setupapi.h) |