Funzione SetupDiInstallDeviceInterfaces (setupapi.h)

  • Articolo

La funzione SetupDiInstallDeviceInterfaces è il gestore predefinito per la richiesta di installazione DIF_INSTALLINTERFACES .

Sintassi

WINSETUPAPI BOOL SetupDiInstallDeviceInterfaces(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Parametri

[in] DeviceInfoSet

Puntatore al set di informazioni sul dispositivo che contiene un elemento informativo del dispositivo che rappresenta il dispositivo per cui installare le interfacce. Il set di informazioni sul dispositivo deve contenere solo elementi per il sistema locale.

[in] DeviceInfoData

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

Valore restituito

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

Commenti

SetupDiInstallDeviceInterfaces elabora ogni voce AddInterface in DDInstall. Sezione Interfacce di un file INF del dispositivo e crea ogni interfaccia chiamando SetupDiCreateDeviceInterface.

Il chiamante di SetupDiInstallDeviceInterfaces deve essere membro del gruppo Administrators.

Nota Solo un programma di installazione della classe deve chiamare SetupDiInstallDeviceInterfaces e solo in tali situazioni in cui il programma di installazione della classe deve eseguire operazioni di installazione dell'interfaccia del dispositivo dopo l'installazione di SetupDiInstallDeviceInterfaces completa l'operazione di installazione predefinita dell'interfaccia del dispositivo. In tali situazioni, il programma di installazione della classe deve chiamare direttamente SetupDiInstallDeviceInterfaces quando il programma di installazione elabora una richiesta di DIF_INSTALLINTERFACES. Per altre informazioni sulla chiamata al gestore predefinito, vedere Chiamata di gestori di codice DIF predefiniti.
 
Per informazioni sul formato di file INF, vedere Sezioni e direttive file INF.

Requisiti

Requisito Valore
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
DLL Setupapi.dll

Vedi anche

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface