DIF_INSTALLINTERFACES

Artigo
06/15/2023

Uma solicitação DIF_INSTALLINTERFACES permite que um instalador participe do registro das interfaces do dispositivo para um dispositivo.

Quando enviado

Depois de registrar os co-instaladores do dispositivo, mas antes de concluir a instalação do dispositivo.

Quem manipula

Co-instalador de classe	Pode manipular
Co-instalador de dispositivo	Pode manipular
Instalador de Classe	Pode manipular

Entrada do instalador

DeviceInfoSet
Fornece um identificador para o conjunto de informações do dispositivo que contém o dispositivo.

DeviceInfoData
Fornece um ponteiro para uma estrutura SP_DEVINFO_DATA que identifica o dispositivo no conjunto de informações do dispositivo.

Parâmetros de instalação do dispositivo
Há parâmetros de instalação do dispositivo (SP_DEVINSTALL_PARAMS) associados ao DeviceInfoData.

Parâmetros de instalação de classe
Nenhum

Saída do instalador

Parâmetros de instalação do dispositivo
Um instalador pode modificar os parâmetros de instalação do dispositivo, mas normalmente não para essa solicitação DIF.

Valor retornado do instalador

Um co-instalador pode retornar NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED ou um código de erro Win32.

Se um instalador de classe lidar com êxito com essa solicitação e SetupDiCallClassInstaller chamar posteriormente o manipulador padrão, o instalador de classe retornará ERROR_DI_DO_DEFAULT.

Se o instalador de classe manipular essa solicitação com êxito, incluindo chamar diretamente o manipulador padrão, o instalador de classe deverá retornar NO_ERROR e SetupDiCallClassInstaller não chamará o manipulador padrão novamente.

Nota O instalador de classe pode chamar diretamente o manipulador padrão, mas o instalador de classe nunca deve tentar substituir as operações do manipulador padrão.

Para obter mais informações sobre como chamar o manipulador padrão, consulte Chamando manipuladores de código DIF padrão.

Se o instalador de classe encontrar um erro, o instalador deverá retornar um código de erro Win32 apropriado e SetupDiCallClassInstaller não chamará posteriormente o manipulador padrão.

Manipulador de código DIF padrão

SetupDiInstallDeviceInterfaces

Operação do instalador

Em resposta a uma solicitação de DIF_INSTALLINTERFACES um instalador pode registrar uma interface do dispositivo programaticamente em vez de ter a interface registrada por meio do arquivo INF. Normalmente, os instaladores fornecidos pelo fornecedor não lidam com essa solicitação DIF.

A menos que o sinalizador DI_NOFILECOPY esteja definido, um instalador que manipula essa solicitação DIF deve copiar arquivos necessários para as interfaces do dispositivo.

Se o sinalizador DI_NOFILECOPY estiver claro, mas o sinalizador DI_NOVCP estiver definido, o instalador deverá enfileirar todas as operações de arquivo para a fila de arquivos fornecida, mas não deve confirmar a fila.

Se um instalador registrar uma interface do dispositivo, um componente do modo kernel para o dispositivo (por exemplo, um driver) deverá chamar IoSetDeviceInterfaceState para habilitar a interface.

Se o instalador retornar um código de erro Win32, o Windows interromperá a instalação.

Para obter mais informações sobre códigos DIF, consulte Manipulando códigos DIF.

Requisitos

Versão	Com suporte no Microsoft Windows 2000 e versões posteriores do Windows.
Cabeçalho	Setupapi.h (inclua Setupapi.h)

Confira também