Función SetupDiGetSelectedDevice (setupapi.h)

  • Artículo

La función SetupDiGetSelectedDevice recupera el elemento de información del dispositivo seleccionado en un conjunto de información del dispositivo.

Sintaxis

WINSETUPAPI BOOL SetupDiGetSelectedDevice(
  [in]  HDEVINFO         DeviceInfoSet,
  [out] PSP_DEVINFO_DATA DeviceInfoData
);

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo para el que se va a recuperar el elemento de información del dispositivo seleccionado.

[out] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que recibe información sobre el elemento de información del dispositivo seleccionado para DeviceInfoSet. El autor de la llamada debe establecer DeviceInfoData.cbSize a sizeof(SP_DEVINFO_DATA). Si un dispositivo no está seleccionado actualmente, se produce un error en la función y se devuelve una llamada a GetLastError ERROR_NO_DEVICE_SELECTED.

Valor devuelto

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

Comentarios

El asistente para instalación suele usar SetupDiGetSelectedDevice.

Requisitos

Requisito Value
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

SP_DEVINFO_DATA

SetupDiSetSelectedDevice