Funzione WdfPreDeviceInstall (wdfinstaller.h)

  • Articolo

[Si applica solo a KMDF]

La funzione WdfPreDeviceInstall del co-installer esegue tutte le operazioni necessarie dal co-installer prima che il programma di installazione non Plug and Play (PnP) crei il servizio in modalità kernel del driver.

Sintassi

ULONG WdfPreDeviceInstall(
  [in]           LPCWSTR InfPath,
  [in, optional] LPCWSTR InfSectionName
);

Parametri

[in] InfPath

Puntatore a una stringa di caratteri wide-character 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-character con terminazione null contenente il nome della sezione Wdf-install-section nel file INF del driver. Per altre informazioni su questo nome, vedere Uso del co-programma di installazione di KmDF. Se questo puntatore è NULL, il co-installer usa WdfSection per il nome.

Valore restituito

WdfPreDeviceInstall restituisce ERROR_SUCCESS se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori di ERROR_XXX aggiuntivi definiti in Winerror.h.

Commenti

Il programma di installazione per i driver basati sul 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 WdfPreDeviceInstall del co-installer, il programma di installazione deve chiamare GetProcAddress dopo che il programma di installazione ha chiamato LoadLibrary per caricare il co-installer.

Se il co-installer determina che il computer deve essere riavviato per completare l'installazione del driver (in genere perché è stata installata una versione precedente del framework), WdfPreDeviceInstall informa il gestore Plug and Play (PnP). Il gestore PnP richiede quindi all'utente che è necessario un riavvio.

Per altre informazioni sulla funzione WdfPreDeviceInstall e i programmi di installazione per i driver basati su framework di dispositivi non PnP, vedere Installazione di un driver non PnP. Per altre informazioni su CreateService, GetProcAddress e LoadLibrary, vedere la documentazione di Microsoft Windows SDK.

Esempio

Per un esempio di codice che usa la funzione WdfPreDeviceInstall , vedere il programma di installazione per l'esempio NONPNP .

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfinstaller.h (includere Wdfinstaller.h)
Libreria N/A (Esportato dalla libreria co-programma di installazione kmDF. Per informazioni sul nome del file della libreria co-installer, vedere Uso del co-programma di installazione kmDF.

Vedi anche

WdfPostDeviceInstall