DIF_INSTALLDEVICEFILES

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

Quando enviado

Os componentes de instalação de dispositivo fornecidos pelo sistema enviar 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

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 aoDeviceInfoData.

Se o sinalizador de DI_NOVCP estiver definido, os parâmetros de instalação do dispositivo conterão um identificador de 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 oFileQueue, 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 lidar com êxito com essa solicitação e SetupDiCallClassInstaller deverá chamar o manipulador padrão, o instalador de classe retornará ERROR_DI_DO_DEFAULT.

Se o instalador de classe lidar com êxito com 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.

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á o manipulador padrão.

Manipulador de código DIF padrão

SetupDiInstallDriverFiles

Operação do instalador

Em resposta a uma solicitação DIF_INSTALLDEVICEFILES, um instalador especifica todas as operações de arquivo necessárias. Por exemplo, um instalador pode especificar outro arquivo a ser copiado necessário para a instalação do dispositivo. Se o sinalizador de DI_NOVCP estiver definido, um instalador especificará as operações de arquivo adicionando-as à 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 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

Consulte também

• SetupDiInstallDriverFiles
• SP_DEVINFO_DATA
• SP_DEVINSTALL_PARAMS