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 |