Función SetupDiSetSelectedDriverA (setupapi.h)

El SetupDiSetSelectedDriver conjuntos de funciones, o restablece, el controlador seleccionado para un elemento de información del dispositivo o el controlador de clase seleccionado para un conjunto de información del dispositivo.

Sintaxis

WINSETUPAPI BOOL SetupDiSetSelectedDriverA(
  [in]      HDEVINFO           DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA   DeviceInfoData,
  [in, out] PSP_DRVINFO_DATA_A DriverInfoData
);

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo que contiene la lista de controladores desde la que seleccionar un controlador para un elemento de información del dispositivo o para el conjunto de información del dispositivo.

[in, out] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet. Este parámetro es opcional y se puede NULL. Si se especifica este parámetro, setupDiSetSelectedDriver establece o restablece, el controlador seleccionado para el dispositivo especificado. Si este parámetro es valores NULL, setDiSetSelectedDriver establece o restablece, el controlador de clase seleccionado para DeviceInfoSet.

[in, out] DriverInfoData

Puntero a una estructura SP_DRVINFO_DATA que especifica el controlador que se va a seleccionar. Este parámetro es opcional y se puede NULL. Si se proporciona este parámetro y deviceInfoData, el controlador especificado debe ser miembro de una lista de controladores asociada a DeviceInfoData. Si se especifica este parámetro y DeviceInfoData es NULL, el controlador debe ser miembro de la lista de controladores de clase global para DeviceInfoSet. Si este parámetro es null, el controlador seleccionado se restablece para el elemento de información del dispositivo, si se especifica DeviceInfoData o el conjunto de información del dispositivo, si DeviceInfoData es NULL.

Si el DriverInfoData. reservado es NULL, el autor de la llamada solicita una búsqueda de un nodo de controlador con los parámetros especificados (DriverType, Descriptiony ProviderName). Si se encuentra una coincidencia, se selecciona ese nodo de controlador. El campo reservado se actualiza en la salida para reflejar el nodo de controlador real donde se encontró la coincidencia. Si no se encuentra una coincidencia, la función produce un error y una llamada a GetLastError devuelve ERROR_INVALID_PARAMETER.

Valor devuelto

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

Observaciones

Si el autor de la llamada de SetupDiSetSelectedDriver es miembro del grupo Administradores, la clase del dispositivo se establece en la clase del controlador seleccionado, siempre que las dos clases sean diferentes.

Si DriverInfoData es null, SetupDiSetSelectedDriver restablece el controlador seleccionado. Como resultado, no hay ningún controlador seleccionado.

Nota

El encabezado setupapi.h define SetupDiSetSelectedDriver como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
de la plataforma de destino de	Escritorio
encabezado de	setupapi.h (incluya Setupapi.h)
biblioteca de	Setupapi.lib

Consulte también

SetupDiGetSelectedDriver