DIF_INSTALLDEVICEFILES

Artigo
06/15/2023

Uma solicitação DIF_INSTALLDEVICEFILES permite que um instalador participe da cópia dos arquivos para dar suporte a um dispositivo ou fazer uma lista dos arquivos de um dispositivo. Os arquivos de dispositivo incluem arquivos para o driver selecionado, quaisquer interfaces de dispositivo e quaisquer co-instaladores.

Quando enviado

Os componentes de instalação do dispositivo fornecidos pelo sistema enviam essa solicitação DIF por vários motivos. Alguns componentes de instalação do dispositivo enviam essa solicitação DIF antes de DIF_REGISTER_COINSTALLERS, DIF_INSTALLINTERFACES e DIF_INSTALL_DEVICE para garantir que todos os arquivos relevantes possam ser copiados antes de prosseguir com a instalação. Alguns componentes de instalação do dispositivo omitem essa solicitação DIF e esperam que os arquivos sejam copiados durante o tratamento dessas três solicitações DIF. Além disso, alguns componentes de instalação do dispositivo enviam essa solicitação DIF para recuperar a lista dos arquivos associados a um dispositivo.

Quem manipula

Co-instalador de classe	Pode manipular
Co-instalador de dispositivo	Não manipula
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 cujos arquivos de suporte devem ser copiados.

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.

Se o sinalizador DI_NOVCP estiver definido, os parâmetros de instalação do dispositivo conterão um identificador FileQueue válido e instaladores que lidam com essa solicitação DIF adicionam suas operações de arquivo a essa fila e não confirmam a fila.

Parâmetros de instalação de classe
Nenhum

Saída do instalador

Parâmetros de instalação do dispositivo
Um instalador pode modificar o FileQueue, se houver um.

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 manipular com êxito essa solicitação e SetupDiCallClassInstaller precisar chamar posteriormente o manipulador padrão, o instalador de classe retornará ERROR_DI_DO_DEFAULT.

Se o instalador de classe manipular com êxito essa solicitação, 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

SetupDiInstallDriverFiles

Operação do instalador

Em resposta a uma solicitação de DIF_INSTALLDEVICEFILES um instalador especifica todas as operações de arquivo necessárias. Por exemplo, um instalador pode especificar um arquivo adicional a ser copiado necessário para a instalação do dispositivo. Se o sinalizador DI_NOVCP estiver definido, um instalador especificará as operações de arquivo adicionando-as ao FileQueue nos parâmetros de instalação do dispositivo. Consulte o SDK do Microsoft Windows para obter informações sobre como usar filas de arquivos e para páginas de referência em funções de enfileiramento de arquivos, como SetupInstallFilesFromInfSection.

Se essa solicitação DIF for enviada durante a instalação do dispositivo e o instalador retornar um código de erro do Microsoft Win32, o Windows interromperá a instalação.

Se um componente de instalação de dispositivo fornecido pelo sistema enviar essa solicitação DIF para recuperar uma lista dos arquivos associados a um dispositivo, o componente recuperará a fila de arquivos, mas não confirmará a fila.

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