Función WdfPreDeviceInstall (wdfinstaller.h)

[Solo se aplica a KMDF]

La función WdfPreDeviceInstall del co-instalador realiza las operaciones que el co-instalador podría requerir antes de que un instalador no Plug and Play (PnP) cree el servicio en modo kernel del controlador.

Sintaxis

ULONG WdfPreDeviceInstall(
  [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, consulte Uso del co-instalador de KMDF. Si este puntero es NULL, el co-instalador usa WdfSection para el nombre.

Valor devuelto

WdfPreDeviceInstall 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 el marco de un dispositivo que no sea PnP debe llamar a WdfPreDeviceInstall o WdfPreDeviceInstallEx antes de que el instalador llame a CreateService.

Para obtener la dirección de la función WdfPreDeviceInstall del co-instalador, el instalador debe llamar a GetProcAddress después de que el instalador haya llamado a LoadLibrary para cargar el co-instalador.

Si el coinstalador determina que el equipo debe reiniciarse para completar la instalación del controlador (normalmente porque se instaló anteriormente una versión anterior del marco), WdfPreDeviceInstall informa al administrador de Plug and Play (PnP). A continuación, el administrador de PnP solicita al usuario que sea necesario reiniciar.

Para obtener más información sobre la función wdfPreDeviceInstall y los instaladores para controladores basados en marcos de dispositivos que no son PnP, consulte Instalación de un controlador que no es PnP. Para obtener más información sobre CreateService, GetProcAddress y LoadLibrary, consulte la documentación de Microsoft Windows SDK.

Ejemplos

Para obtener un ejemplo de código que usa la función WdfPreDeviceInstall , consulte el instalador del ejemplo NONPNP .

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdfinstaller.h (incluya Wdfinstaller.h)
Library	N/A (exportada por la biblioteca co-instalador de KMDF. Para obtener información sobre el nombre del archivo de instalación conjunta de la biblioteca, consulte Uso del co-instalador de KMDF).

Consulte también

WdfPostDeviceInstall