Funzione NetDeviceRequestReset (netadaptercx.h)
La funzione NetDeviceRequestReset attiva il framework NetAdapterCx per eseguire l'operazione di reimpostazione del dispositivo a livello di piattaforma che ripristina un dispositivo NIC non risponde.
Sintassi
void NetDeviceRequestReset(
[_In_] WDFDEVICE Device
);
Parametri
[_In_] Device
Oggetto WDFDEVICE creato in precedenza con una chiamata a WdfDeviceCreate.
Valore restituito
Nessuno
Osservazioni
Un driver client chiama NetDeviceRequestReset quando rileva un errore del dispositivo. NetDeviceRequestReset restituisce immediatamente al driver client. Il driver può chiamare solo NetDeviceRequestReset in PASSIVE_LEVEL.
netDeviceRequestReset non blocca e restituisce immediatamente al driver client. Il driver client deve annullare tutti i processi in corso che accedono al dispositivo attualmente non riuscito.
È consigliabile che i driver client configurino una struttura di NET_DEVICE_RESET_CAPABILITIES per raccogliere dati di diagnostica significativi durante il processo di reimpostazione e ripristino del dispositivo. Per altre informazioni su come raccogliere la diagnostica di reimpostazione, vedere Registrare il callback facoltativo della raccolta di diagnostica.
NetDeviceRequestReset è applicabile solo per i dispositivi NIC basati su PCIe. Per i dispositivi NIC basati su USB, seguire il processo descritto in Come eseguire il ripristino da errori della pipe USB.
Se il dispositivo rileva un errore hardware o software irreversibile, il driver client può usare la funzione WdfDeviceSetFailed.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 11 |
| server minimo supportato | Windows Server 2022 |
| versione minima di UMDF | 2.33 |
| intestazione | netadaptercx.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
Vedere anche
Ripristino di una scheda di interfaccia di rete non risponde con NetAdapterCx PLDR