Función SetupDiSelectOEMDrv (setupapi.h)

La función SetupDiSelectOEMDrv selecciona un controlador para un conjunto de información del dispositivo o un elemento de información de dispositivo determinado que usa una ruta de acceso oem proporcionada por el usuario.

Sintaxis

WINSETUPAPI BOOL SetupDiSelectOEMDrv(
  [in, optional] HWND             hwndParent,
  [in]           HDEVINFO         DeviceInfoSet,
  [in, out]      PSP_DEVINFO_DATA DeviceInfoData
);

Parámetros

[in, optional] hwndParent

Identificador de ventana que será el elemento primario de los diálogos creados durante el procesamiento de esta función. Este parámetro se puede usar para invalidar el campo hwndParent en el bloque de parámetros de instalación del conjunto o elemento de información del dispositivo especificado.

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo para el que se va a seleccionar un controlador.

[in, out] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica un elemento de información del dispositivo en DeviceInfoSet. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, SetupDiSelectOEMDrv asocia el controlador seleccionado al dispositivo especificado. Si este parámetro es NULL, SetupDiSelectOEMDrv asocia el controlador seleccionado a la lista global de controladores de clase para DeviceInfoSet.

Valor devuelto

La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar mediante una llamada a GetLastError.

Comentarios

SetupDiSelectOEMDrv está diseñado principalmente para seleccionar un controlador OEM para un dispositivo en un equipo local antes de instalar el dispositivo en ese equipo. Aunque SetupDiSelectOEMDrv no producirá un error si el conjunto de información del dispositivo es para un equipo remoto, el resultado es de uso limitado porque el conjunto de información del dispositivo no se puede usar posteriormente con solicitudes de instalación DIF_Xxx o funciones SetupDiXxx que no admiten operaciones en un equipo remoto. En concreto, el conjunto de información del dispositivo no se puede usar como entrada con una solicitud de instalación de DIF_INSTALLDEVICE para instalar un dispositivo en un equipo remoto.

SetupDiSelectOEMDrv solicita al usuario la ruta de acceso del OEM y, a continuación, llama al instalador de clase para seleccionar un controlador de la ruta de acceso del OEM.

Requisitos

Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	setupapi.h (incluya Setupapi.h)
Library	Setupapi.lib
Archivo DLL	Setupapi.dll

Consulte también

SetupDiAskForOEMDisk