Funzione SetupDiGetDeviceInstanceIdA (setupapi.h)
La funzione SetupDiGetDeviceInstanceId recupera l'ID dell'istanza del dispositivo associato a un elemento informazioni sul 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 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 di 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 di 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 ha esito positivo, la funzione restituisce TRUE. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError.
Osservazioni
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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| 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 |