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

Vedi anche

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo