Funzione SetupDiGetDeviceInstanceIdA (setupapi.h)
La funzione SetupDiGetDeviceInstanceId recupera l'ID istanza del dispositivo associato a un elemento informazioni dispositivo.
Nota
In Windows Vista e versioni successive di Windows, il modello di proprietà del dispositivo unificato usa la chiave della proprietàDEVPKEY_Device_InstanceId per rappresentare l'identificatore dell'istanza del dispositivo. Per informazioni dettagliate, vedere Recupero di un identificatore di istanza del dispositivo .
Sintassi
WINSETUPAPI BOOL SetupDiGetDeviceInstanceIdA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[out, optional] PSTR DeviceInstanceId,
[in] DWORD DeviceInstanceIdSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo contenente l'elemento informazioni del dispositivo che rappresenta il dispositivo per cui recuperare un ID istanza del dispositivo.
[in] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet.
[out, optional] DeviceInstanceId
Puntatore al buffer di caratteri che riceverà l'ID istanza del dispositivo con terminazione NULL per l'elemento informativo del dispositivo specificato. Per informazioni sugli ID istanza del dispositivo, vedere Stringhe di identificazione del dispositivo.
[in] DeviceInstanceIdSize
Dimensioni, in caratteri, del buffer DeviceInstanceId .
[out, optional] RequiredSize
Puntatore alla variabile che riceve il numero di caratteri necessari per archiviare l'ID istanza del dispositivo.
Valore restituito
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato eseguendo una chiamata a GetLastError.
Commenti
Nota
L'intestazione setupapi.h definisce SetupDiGetDeviceInstanceId come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (includere Setupapi.h) |
| Libreria | Setupapi.lib |