Funzione SetupDiGetDeviceInstanceIdW (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 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 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

Vedere anche

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo