Función SetupDiGetDeviceInstanceIdA (setupapi.h)

Artículo
03/15/2023

La función SetupDiGetDeviceInstanceId recupera el identificador de instancia de dispositivo asociado a un elemento de información del dispositivo.

Nota

En Windows Vista y versiones posteriores de Windows, el modelo de propiedad de dispositivo unificado usa la clave de propiedad DEVPKEY_Device_InstanceId para representar el identificador de instancia del dispositivo. Consulte Recuperación de un identificador de instancia de dispositivo para obtener más información.

Sintaxis

WINSETUPAPI BOOL SetupDiGetDeviceInstanceIdA(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [out, optional] PSTR             DeviceInstanceId,
  [in]            DWORD            DeviceInstanceIdSize,
  [out, optional] PDWORD           RequiredSize
);

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo que contiene el elemento de información del dispositivo que representa el dispositivo para el que se va a recuperar un identificador de instancia de dispositivo.

[in] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet.

[out, optional] DeviceInstanceId

Puntero al búfer de caracteres que recibirá el identificador de instancia de dispositivo terminado en NULL para el elemento de información del dispositivo especificado. Para obtener información sobre los identificadores de instancia de dispositivo, consulte Cadenas de identificación de dispositivos.

[in] DeviceInstanceIdSize

Tamaño, en caracteres, del búfer DeviceInstanceId .

[out, optional] RequiredSize

Puntero a la variable que recibe el número de caracteres necesarios para almacenar el identificador de instancia del dispositivo.

Valor devuelto

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

Comentarios

Nota

El encabezado setupapi.h define SetupDiGetDeviceInstanceId 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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