Calling SetupAPI Functions
Rules for calling SetupAPI functions
Class installers and co-installers must not call the following SetupAPI functions:
Note Class installers and co-installers are prohibited from calling SetupScanFileQueue only when the SPQ_SCAN_PRUNE_COPY_QUEUE flag is set in the Flags parameter.
Rules for calling the default DIF code handler functions
Default device installation function (DIF) code handler functions perform system-defined default operations for certain DIF codes. As described in Handling DIF Codes, SetupDiCallClassInstaller calls the default handler for a DIF request after the co-installer has first processed the DIF request, but before SetupDiCallClassInstaller calls the co-installers that registered for post-processing of the request.
Co-installers and device installation applications must not call the default DIF code handler functions. Direct calls to these handler functions bypass all registered co-installers and could invalidate any internal device state that these installers store.
The following table lists the DIF codes that have default DIF code handler functions.