Función WdfPreDeviceInstallEx (wdfinstaller.h)

[Solo se aplica a KMDF]

La función WdfPreDeviceInstallEx del co-instalador realiza cualquier operación que el co-instalador pueda requerir antes de que un instalador no Plug and Play (PnP) cree el servicio en modo kernel del controlador.

Sintaxis

ULONG WdfPreDeviceInstallEx(
  [in]           LPCWSTR                          InfPath,
  [in, optional] LPCWSTR                          InfSectionName,
  [in]           PWDF_COINSTALLER_INSTALL_OPTIONS ClientOptions
);

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.

[in] ClientOptions

Puntero a una estructura de tipo WDF_COINSTALLER_INSTALL_OPTIONS asignada por el autor de la llamada que contiene las opciones de instalación especificadas por el controlador.

Valor devuelto

WdfPreDeviceInstallEx 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 que se definen en Winerror.h.

Comentarios

El instalador de los controladores basados en marcos 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 WdfPreDeviceInstallEx 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 co-instalador determina que el equipo debe reiniciarse para completar la instalación del controlador (normalmente porque se instaló anteriormente una versión anterior del marco), la función WdfPreDeviceInstallEx le permite controlar cuándo o si se le pide al usuario que reinicie el equipo, como se indica a continuación:

• Si el instalador establece el miembro ShowRebootPrompt de la estructura de WDF_COINSTALLER_INSTALL_OPTIONS en TRUE, WdfPreDeviceInstallEx informa al administrador de PnP de que se debe reiniciar el equipo y el administrador de PnP solicita al usuario que sea necesario reiniciar. Establecer el miembro ShowRebootPrompt enTRUE equivale a llamar a WdfPreDeviceInstall.
• Si el instalador establece el miembro ShowRebootPrompt de la estructura de WDF_COINSTALLER_INSTALL_OPTIONS en FALSE, WdfPreDeviceInstallEx no informa al administrador de PnP de que es necesario reiniciar. En su lugar, la función devuelve ERROR_SUCCESS_REBOOT_REQUIRED. El instalador puede determinar cuándo o si se debe reiniciar el equipo,

Para obtener más información sobre la función Y los instaladores de WdfPreDeviceInstallEx 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 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 WdfPreDeviceInstallEx , consulte el instalador del ejemplo NONPNP .

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1,9
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).

Consulte también

WdfPostDeviceInstall

WdfPreDeviceInstall