DIF_UNREMOVE

Artículo
06/15/2023

Una solicitud DIF_UNREMOVE notifica al instalador que Windows está a punto de restablecer un dispositivo en un perfil de hardware determinado y ofrece al instalador la oportunidad de participar en la operación. Windows solo envía esta solicitud para dispositivos que no son PnP.

Cuándo se envió

Cuando un dispositivo no PnP enumerado en raíz se restablece a un perfil de hardware.

Quién controla

Coinserción de clase	Puede controlar
Instalador conjunta 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
Una estructura de SP_UNREMOVEDEVICE_PARAMS está asociada a DeviceInfoData. El campo Ámbito debe establecerse en DI_UNREMOVEDEVICE_CONFIGSPECIFIC y se debe especificar un perfil de hardware en el campo HwProfile .

Salida del instalador

Ninguno

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

SetupDiUnremoveDevice

Operación del instalador

"Unremoving" un dispositivo significa básicamente que Windows borra una marca que antes marcaba un dispositivo como "no presente" en un perfil de hardware determinado.

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