Compartilhar via


Função SetupDiInstallDeviceInterfaces (setupapi.h)

A função SetupDiInstallDeviceInterfaces é o manipulador padrão para a solicitação de instalação DIF_INSTALLINTERFACES .

Sintaxe

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

Parâmetros

[in] DeviceInfoSet

Um ponteiro para o conjunto de informações do dispositivo que contém um elemento de informações do dispositivo que representa o dispositivo para o qual instalar interfaces. O conjunto de informações do dispositivo deve conter apenas elementos para o sistema local.

[in] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em DeviceInfoSet.

Retornar valor

SetupDiInstallDeviceInterfaces retornará TRUE se a função for concluída sem erro. Se a função for concluída com um erro, FALSE será retornado e o código de erro para a falha poderá ser recuperado chamando GetLastError.

Comentários

SetupDiInstallDeviceInterfaces processa cada entrada AddInterface na DDInstall. A seção Interfaces de um arquivo INF do dispositivo e cria cada interface chamando SetupDiCreateDeviceInterface.

O chamador de SetupDiInstallDeviceInterfaces deve ser um membro do grupo Administradores.

Nota Somente um instalador de classe deve chamar SetupDiInstallDeviceInterfaces e somente nas situações em que o instalador de classe deve executar operações de instalação da interface do dispositivo depois que SetupDiInstallDeviceInterfaces concluir a operação de instalação da interface do dispositivo padrão. Nessas situações, o instalador de classe deve chamar diretamente SetupDiInstallDeviceInterfaces quando o instalador processa uma solicitação de DIF_INSTALLINTERFACES. Para obter mais informações sobre como chamar o manipulador padrão, consulte Chamando manipuladores de código DIF padrão.
 
Para obter informações sobre o formato de arquivo INF, consulte Seções e diretivas de arquivo INF.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho setupapi.h (inclua Setupapi.h)
Biblioteca Setupapi.lib
DLL Setupapi.dll

Confira também

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface