Partilhar via

Chamando os manipuladores de código DIF padrão

  • Artigo

Observação

Os recursos descritos nesta seção não têm suporte em pacotes de driver móveis ou universais. Consulte Usando um arquivo INF universal.

Manipuladores de código DIF padrão executam operações padrão definidas pelo sistema para códigos DIF. Conforme descrito em Manipulando códigos DIF, SetupDiCallClassInstaller chama o manipulador padrão para uma solicitação DIF depois que o instalador de classe e o co-instalador primeiro processaram a solicitação DIF, mas antes de SetupDiCallClassInstaller lembrar os co-instaladores que se registraram para pós-processamento da solicitação.

Nota A operação de SetupDiCallClassInstaller não pode ser configurada para recuperar o instalador de classe para pós-processar uma solicitação DIF.

Nessas situações em que um instalador de classe deve executar operações para uma solicitação DIF depois que o manipulador padrão é chamado, o instalador de classe deve chamar diretamente o manipulador padrão ao processar a solicitação DIF, da seguinte maneira:

  1. Execute operações que devem ser feitas antes de chamar o manipulador padrão.

  2. Chame o manipulador padrão para executar as operações padrão.

    Nota O instalador de classe não deve tentar substituir a operação do manipulador padrão.

  3. Execute as operações que devem ser feitas após o retorno do manipulador padrão.

  4. Retornar NO_ERROR se o instalador de classe tiver concluído com êxito o processamento da solicitação DIF ou retornar um erro win32 se o processamento falhar.

ImportanteOs co-instaladores e os aplicativos de instalação de dispositivo não devem chamar os manipuladores de código DIF padrão.

Para obter um exemplo de uma situação em que esse método deve ser usado, consulte as informações sobre como chamar o manipulador padrão SetupDiInstallDevice na página de referência de solicitação DIF_INSTALLDEVICE .

A tabela a seguir lista os códigos DIF que têm manipuladores padrão.

Código DIF Função de manipulador de código DIF padrão
DIF_PROPERTYCHANGE SetupDiChangeState
DIF_FINISHINSTALL_ACTION SetupDiFinishInstallAction
DIF_INSTALLDEVICE SetupDiInstallDevice
DIF_INSTALLINTERFACES SetupDiInstallDeviceInterfaces
DIF_INSTALLDEVICEFILES SetupDiInstallDriverFiles
DIF_REGISTER_COINSTALLERS SetupDiRegisterCoDeviceInstallers
DIF_REGISTERDEVICE SetupDiRegisterDeviceInfo
DIF_REMOVE SetupDiRemoveDevice
DIF_SELECTBESTCOMPATDRV SetupDiSelectBestCompatDrv
DIF_SELECTDEVICE SetupDiSelectDevice
DIF_UNREMOVE SetupDiUnremoveDevice