DIF_REGISTERDEVICE

Articolo
06/15/2023

La DIF_REGISTERDEVICE richiesta consente a un programma di installazione di partecipare alla registrazione di un'istanza di dispositivo appena creata con gestione PnP. Windows invia questa richiesta DIF per i dispositivi non PnP.

Data di invio

Quando un programma di installazione segnala un dispositivo precedentemente sconosciuto in risposta a una richiesta di DIF_DETECT . Windows invia questa richiesta DIF nella fase di analisi dell'Aggiunta guidata hardware prima di installare il dispositivo. Windows invia anche questa richiesta durante il rilevamento non PnP.

Chi gestisce

Co-installer di classe	Può gestire
Programma di installazione condivisa del dispositivo	Non gestisce
Programma di installazione classi	Può gestire

Input del programma di installazione

DeviceInfoSet
Fornisce un handle al set di informazioni del dispositivo che contiene il dispositivo.

DeviceInfoData
Fornisce un puntatore a una struttura SP_DEVINFO_DATA che identifica il dispositivo nel set di informazioni sul dispositivo.

Parametri di installazione del dispositivo
Sono disponibili parametri di installazione del dispositivo (SP_DEVINSTALL_PARAMS) associati a DeviceInfoData.

Parametri di installazione della classe
Nessuno

Output del programma di installazione

Nessuno

Valore restituito dal programma di installazione

Un co-installer può restituire NO_ERROR o un codice di errore Win32. Un co-installer non deve restituire ERROR_DI_POSTPROCESSING_REQUIRED per questa richiesta DIF.

Se un programma di installazione determina che il dispositivo è un duplicato, restituisce ERROR_DUPLICATE_FOUND.

Se un programma di installazione della classe gestisce correttamente questa richiesta e SetupDiCallClassInstaller deve successivamente chiamare il gestore predefinito, il programma di installazione della classe restituisce ERROR_DI_DO_DEFAULT.

Se il programma di installazione della classe gestisce correttamente questa richiesta, inclusa la chiamata diretta al gestore predefinito, il programma di installazione della classe deve restituire NO_ERROR e SetupDiCallClassInstaller non chiamerà di nuovo il gestore predefinito.

Nota Il programma di installazione della classe può chiamare direttamente il gestore predefinito, ma il programma di installazione della classe non deve mai tentare di sostituire le operazioni del gestore predefinito.

Per altre informazioni sulla chiamata al gestore predefinito, vedere Chiamata di gestori di codice DIF predefiniti.

Se il programma di installazione della classe riscontra un errore, il programma di installazione deve restituire un codice di errore Win32 appropriato e SetupDiCallClassInstaller non chiamerà successivamente il gestore predefinito.

Se il programma di installazione determina che il dispositivo è un duplicato, il programma di installazione restituisce ERROR_DUPLICATE_FOUND.

Gestore di codice DIF predefinito

SetupDiRegisterDeviceInfo

Operazione del programma di installazione

Un'applicazione di installazione del dispositivo invia in genere questa richiesta DIF per registrare un dispositivo non PnP con la gestione PnP. A partire da Microsoft Windows 2000, i dispositivi non PnP devono essere registrati prima di poter essere installati.

Un programma di installazione gestisce in genere questa richiesta DIF per eseguire il rilevamento duplicato. In genere un programma di installazione chiama il gestore predefinito (SetupDiRegisterDeviceInfo) e specifica la routine di rilevamento. Se la registrazione ha esito positivo e il programma di installazione determina che il dispositivo non è un duplicato, il programma di installazione restituisce NO_ERROR.

Un co-installer deve eseguire tutte le operazioni per gestire questa richiesta DIF nel passaggio di pre-elaborazione. Quando il co-installer viene chiamato per la post-elaborazione, l'istanza del dispositivo è già stata registrata dal programma di installazione della classe o dal gestore predefinito.

Se un programma di installazione restituisce un errore per questo codice DIF, in genere ERROR_DUPLICATE_FOUND, Windows elimina il dispositivo dal set di informazioni sul dispositivo.

Per altre informazioni sui codici DIF, vedere Gestione dei codici DIF.