Funzione ZwUnloadDriver (wdm.h)
La routine ZwUnloadDriver scarica un driver dal sistema. Usare questa routine con attenzione estrema (vedere la sezione Osservazioni di seguito).
Sintassi
NTSYSAPI NTSTATUS ZwUnloadDriver(
[in] PUNICODE_STRING DriverServiceName
);
Parametri
[in] DriverServiceName
Puntatore a una stringa Unicode conteggiata che specifica un percorso alla chiave del Registro di sistema del driver, , \Registry\Machine\System\CurrentControlSet\Services\<DriverName>dove DriverName è il nome del driver.
Valore restituito
ZwUnloadDriver restituisce STATUS_SUCCESS o un valore NTSTATUS di errore, ad esempio STATUS_INVALID_DEVICE_REQUEST.
Se il driver specificato in DriverServiceName non ha alcuna routine di callback DriverUnload impostata nella relativa struttura di DRIVER_OBJECT, ZwUnloadDriver restituisce STATUS_INVALID_DEVICE_REQUEST.
Commenti
ZwUnloadDriver scarica dinamicamente un driver di dispositivo o file system dal sistema attualmente in esecuzione. Non è consigliabile che un driver chiami ZwUnloadDriver su se stesso.
Un driver di filtro del file system non può essere scaricato in modo sicuro da un sistema in esecuzione. Pertanto, un filtro deve usare solo ZwUnloadDriver per scopi di debug. Non deve chiamare questa routine in una versione al dettaglio del filtro.
Se DriverName è il nome di un driver di dispositivo PnP, ZwUnloadDriver restituisce STATUS_INVALID_DEVICE_REQUEST e non scarica il driver.
Un minifilter deve usare FltUnloadFilter anziché ZwUnloadDriver per scaricare un minifilter di supporto.
Se la chiamata alla funzione ZwUnloadDriver si verifica in modalità utente, è necessario usare il nome "NtUnloadDriver" anziché "ZwUnloadDriver".
Per le chiamate dai driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Uso di nt e zw versioni delle routine di Servizi di sistema nativo.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |
Vedi anche
Uso di nt e zw versioni delle routine di Servizi di sistema nativo