Función WdfPreDeviceRemove (wdfinstaller.h)
[Solo se aplica a KMDF]
La función WdfPreDeviceRemove del co-instalador realiza cualquier operación que el co-instalador pueda requerir antes de que un instalador no Plug and Play (PnP) elimine el servicio en modo kernel del controlador.
Sintaxis
ULONG WdfPreDeviceRemove(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName
);
Parámetros
[in] InfPath
Puntero a una cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso del directorio al archivo INF del controlador. El instalador del controlador puede obtener esta cadena llamando a GetCurrentDirectory, que se describe en el Microsoft Windows SDK.
[in, optional] InfSectionName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre de la sección Wdf-install-section en el archivo INF del controlador. Para obtener más información sobre este nombre, vea Uso del co-instalador de KMDF. Si este puntero es NULL, el co-instalador usa WdfSection para el nombre.
Valor devuelto
WdfPreDeviceRemove devuelve ERROR_SUCCESS si la operación se realiza correctamente. De lo contrario, la función devuelve uno de los valores de ERROR_XXX adicionales definidos en Winerror.h.
Comentarios
El instalador de los controladores basados en marcos de un dispositivo que no sea PnP debe llamar a WdfPreDeviceRemove antes de que el instalador llame a DeleteService.
Para obtener la dirección de la función WdfPreDeviceRemove del co-instalador, el instalador debe llamar a GetProcAddress después de que el instalador haya llamado a LoadLibrary para cargar el co-instalador.
Para obtener más información sobre la función WdfPreDeviceRemove e instaladores para controladores basados en marcos de dispositivos que no son PnP, consulte Instalación de un controlador que no sea PnP. Para obtener más información sobre DeleteService, GetProcAddress y LoadLibrary, consulte la documentación de Microsoft Windows SDK.
Ejemplos
Para obtener un ejemplo de código que usa la función WdfPreDeviceRemove , consulte el instalador del ejemplo NONPNP .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfinstaller.h (incluir Wdfinstaller.h) |
| Library | N/A (exportada por la biblioteca co-instalador de KMDF. Para obtener información sobre el nombre de archivo de la biblioteca co-instalador, vea Uso del co-instalador de KMDF). |