Funzione WdfPreDeviceInstallEx (wdfinstaller.h)
[Si applica solo a KMDF]
La funzione WdfPreDeviceInstallEx del programma di installazione condivisa esegue tutte le operazioni che il co-programma di installazione potrebbe richiedere prima che il programma di installazione di un driver non Plug and Play (PnP) crei il servizio in modalità kernel del driver.
Sintassi
ULONG WdfPreDeviceInstallEx(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName,
[in] PWDF_COINSTALLER_INSTALL_OPTIONS ClientOptions
);
Parametri
[in] InfPath
Puntatore a una stringa di caratteri wide con terminazione Null contenente il percorso della directory del file INF del driver. Il programma di installazione del driver può ottenere questa stringa chiamando GetCurrentDirectory, descritto nella Microsoft Windows SDK.
[in, optional] InfSectionName
Puntatore a una stringa di caratteri wide con terminazione Null contenente il nome della sezione Wdf-install-section nel file INF del driver. Per altre informazioni su questo nome, vedere Using the KMDF Co-installer.For more information about this name, see Using the KMDF Co-installer. Se questo puntatore è NULL, il co-programma di installazione usa WdfSection per il nome.
[in] ClientOptions
Puntatore a una struttura tipizzata WDF_COINSTALLER_INSTALL_OPTIONS del chiamante che contiene le opzioni di installazione specificate dal driver.
Valore restituito
WdfPreDeviceInstallEx restituisce ERROR_SUCCESS se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori aggiuntivi ERROR_XXX definiti in Winerror.h.
Commenti
Il programma di installazione per i driver basati su framework di un dispositivo non PnP deve chiamare WdfPreDeviceInstall o WdfPreDeviceInstallEx prima che il programma di installazione chiami CreateService.
Per ottenere l'indirizzo della funzione WdfPreDeviceInstallEx del programma di installazione condivisa, il programma di installazione deve chiamare GetProcAddress dopo che il programma di installazione ha chiamato LoadLibrary per caricare il co-programma di installazione.
Se il programma di installazione condivisa determina che il computer deve essere riavviato per completare l'installazione del driver (in genere perché è stata installata una versione precedente del framework), la funzione WdfPreDeviceInstallEx consente di controllare quando o se all'utente viene richiesto di riavviare il computer, come indicato di seguito:
- Se il programma di installazione imposta il membro ShowRebootPrompt della struttura WDF_COINSTALLER_INSTALL_OPTIONSsu TRUE, WdfPreDeviceInstallEx informa il gestore PnP che il computer deve essere riavviato e il manager PnP richiede all'utente che è necessario riavviare il computer. L'impostazione del membro ShowRebootPrompt su TRUE equivale a chiamare WdfPreDeviceInstall.
- Se il programma di installazione imposta il membro ShowRebootPrompt della struttura WDF_COINSTALLER_INSTALL_OPTIONS su FALSE, WdfPreDeviceInstallEx non informa il gestore PnP che è necessario un riavvio. La funzione restituisce invece ERROR_SUCCESS_REBOOT_REQUIRED. Il programma di installazione può determinare quando o se riavviare il computer,
Esempio
Per un esempio di codice che usa la funzione WdfPreDeviceInstallEx , vedere il programma di installazione per l'esempio NONPNP .
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1,9 |
| Intestazione | wdfinstaller.h (include Wdfinstaller.h) |
| Libreria | N/D (esportato dalla libreria co-programma di installazione kmdf. Per informazioni sul nome file della libreria di co-installazione, vedere Uso del co-programma di installazione di KMDF. |