Función SetupDiGetDeviceInstanceIdA (setupapi.h)
La función SetupDiGetDeviceInstanceId recupera el identificador de instancia de dispositivo que está asociado a un elemento de información del dispositivo.
Nota
En Windows Vista y versiones posteriores de Windows, el modelo de propiedades de dispositivo unificado usa la clave de propiedad DEVPKEY_Device_InstanceId para representar el identificador de instancia del dispositivo. Consulte Recuperar 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 de la 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 con 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 de 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 ejecuta correctamente. De lo contrario, devuelve FALSE y se puede recuperar el error registrado realizando una llamada a GetLastError.
Observaciones
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 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 |