Funzione SetupDiCreateDeviceInterfaceW (setupapi.h)

La funzione SetupDiCreateDeviceInterface registra un'interfaccia del dispositivo in un sistema locale o in un sistema remoto.

Sintassi

WINSETUPAPI BOOL SetupDiCreateDeviceInterfaceW(
  [in]            HDEVINFO                  DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA          DeviceInfoData,
  [in]            const GUID                *InterfaceClassGuid,
  [in, optional]  PCWSTR                    ReferenceString,
  [in]            DWORD                     CreationFlags,
  [out, optional] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);

Parametri

[in] DeviceInfoSet

Handle per un set di informazioni sul dispositivo . Questo set contiene un elemento di informazioni sul dispositivo che rappresenta il dispositivo per il quale registrare un'interfaccia. Questo handle viene in genere restituito da SetupDiGetClassDevs.

[in] DeviceInfoData

Puntatore a una struttura di SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet.

[in] InterfaceClassGuid

Puntatore a un GUID di classe che specifica la classe di interfaccia per la nuova interfaccia.

[in, optional] ReferenceString

Puntatore a una stringa con terminazione NULL che fornisce una stringa di riferimento. Questo puntatore è facoltativo e può essere NULL. Le stringhe di riferimento vengono usate solo da alcuni driver di bus che usano interfacce di dispositivo come segnaposto per i dispositivi software creati su richiesta.

[in] CreationFlags

Riservato. Deve essere zero.

[out, optional] DeviceInterfaceData

Puntatore a una struttura di SP_DEVICE_INTERFACE_DATA inizializzata dal chiamante per ricevere informazioni sulla nuova interfaccia del dispositivo. Questo puntatore è facoltativo e può essere NULL. Se viene fornita la struttura, il chiamante deve impostare il membro cbSize di questa struttura su sizeof(SP_DEVICE_INTERFACE_DATA) prima di chiamare questa funzione. Per altre informazioni, vedere la sezione osservazioni seguente.

Valore restituito

SetupDiCreateDeviceInterface restituisce TRUE se la funzione è stata completata senza errori. Se la funzione è stata completata con un errore, restituisce FALSE e il codice di errore per l'errore può essere recuperato chiamando GetLastError.

Osservazioni

Il chiamante di questa funzione deve essere membro del gruppo Administrators.

SetupDiCreateDeviceInterface registra un'interfaccia per un dispositivo. Se un dispositivo ha più di un'interfaccia, chiamare questa funzione una volta per ogni interfaccia registrata.

Se questa funzione registra correttamente un'interfaccia per il dispositivo che corrisponde all'elemento di informazioni sul dispositivo specificato, aggiunge anche l'interfaccia all'elenco di interfacce associato all'elemento informazioni sul dispositivo nel set di informazioni del dispositivo specificato.

Prima che un'interfaccia registrata possa essere usata dalle applicazioni e da altri componenti di sistema, l'interfaccia deve essere abilitata dal driver per il dispositivo.

Questa funzione crea una chiave del Registro di sistema per la nuova interfaccia del dispositivo. I chiamanti di questa funzione possono accedere all'archiviazione non volatile in questa chiave usando SetupDiOpenDeviceInterfaceRegKey.

Se SetupDiCreateDeviceInterface crea correttamente una nuova interfaccia del dispositivo, ma il buffer fornito dal chiamante nel parametro DeviceInterfaceData non è valido, questa funzione restituirà false e una successiva chiamata a GetLastError restituirà ERROR_INVALID_USER_BUFFER. Tuttavia, la funzione crea e registra la nuova interfaccia del dispositivo.

Fabbisogno

Vedere anche

SetupDiOpenDeviceInterfaceRegKey

SetupDiRemoveDeviceInterface