Funzione SetupDiGetDeviceInstanceIdW (setupapi.h)
La funzione SetupDiGetDeviceInstanceId recupera l'ID istanza del dispositivo associato a un elemento informazioni sul dispositivo.
Nota
In Windows Vista e versioni successive di Windows, il modello di proprietà 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 SetupDiGetDeviceInstanceIdW(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[out, optional] PWSTR DeviceInstanceId,
[in] DWORD DeviceInstanceIdSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo che contiene l'elemento informazioni sul dispositivo che rappresenta il dispositivo per il quale 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 informazioni sul 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
Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |