Funcionalidade do co-instalador

Observação

Os recursos descritos nesta seção não têm suporte e os pacotes de driver que os contêm não receberão mais uma assinatura da Microsoft. Consulte Usando um arquivo INF universal.

Um co-instalador é uma DLL Win32 no modo de usuário que normalmente grava informações de configuração adicionais no registro ou executa outras tarefas de instalação que exigem informações que não estão disponíveis quando um INF é gravado.

Um co-instalador pode fazer alguns ou todos os seguintes procedimentos:

• Manipule um ou mais códigos de função de instalação do dispositivo (códigos DIF) recebidos pela função de ponto de entrada do co-instalador .

• Execute operações antes que a classe associada ou o instalador de dispositivo seja chamado, depois que o instalador de classe ou dispositivo for chamado, ou ambos, conforme descrito em Operação do Co-instalador.

• Forneça páginas de propriedades do dispositivo, que são exibidas por Gerenciador de Dispositivos para que os usuários possam modificar os parâmetros do dispositivo.

• A partir do Windows Vista, forneça ações de instalação final (em resposta a uma solicitação de DIF_FINISHINSTALL_ACTION ) para instalar aplicativos.

Quando chamado para pós-processamento, um co-instalador deve verificar o membro InstallResult da estrutura COINSTALLER_CONTEXT_DATA . Se seu valor não for NO_ERROR, o co-instalador deverá fazer todas as operações de limpeza necessárias e retornar um valor apropriado para InstallResult.

Às vezes, os co-instaladores podem obter informações do usuário. Essas informações podem incluir parâmetros de dispositivo adicionais ou se o usuário deseja que aplicativos específicos do dispositivo sejam instalados. Os co-instaladores podem criar interfaces do usuário fornecendo páginas de "concluir instalação" e páginas de propriedades do dispositivo. Nenhuma outra forma de interface do usuário é permitida. O Windows exibe páginas de "concluir instalação" no final da instalação (dentro da Atualização de Hardware ou Novo Hardware Encontrado). Gerenciador de Dispositivos exibe páginas de propriedades e permite que usuários com privilégio de administrador modifiquem os parâmetros exibidos nessas páginas.