NetDeviceRequestReset, fonction (netadaptercx.h)
La fonction NetDeviceRequestReset déclenche l’infrastructure NetAdapterCx pour effectuer l’opération de réinitialisation d’appareil au niveau de la plateforme qui récupère un périphérique de carte réseau qui ne répond pas.
Syntaxe
void NetDeviceRequestReset(
[_In_] WDFDEVICE Device
);
Paramètres
[_In_] Device
Objet WDFDEVICE créé précédemment par le pilote client avec un appel à WdfDeviceCreate.
Valeur de retour
None
Remarques
Un pilote client appelle NetDeviceRequestReset lorsqu’il détecte une défaillance de l’appareil. NetDeviceRequestReset retourne immédiatement au pilote client. Le pilote peut uniquement appeler NetDeviceRequestReset à PASSIVE_LEVEL.
NetDeviceRequestReset n’est pas bloquant et retourne immédiatement au pilote client. Le pilote client doit annuler toutes les tâches en cours qui accèdent à l’appareil actuellement défaillant.
Nous recommandons aux pilotes clients de configurer une structure de NET_DEVICE_RESET_CAPABILITIES pour collecter des diagnostics de réinitialisation significatives pendant le processus de réinitialisation et de récupération de l’appareil. Pour plus d’informations sur la collecte des diagnostics de réinitialisation, consultez Inscrire le rappel facultatif diagnostics collection.
NetDeviceRequestReset s’applique uniquement aux appareils de carte réseau PCIe. Pour les périphériques de carte réseau USB, suivez le processus décrit dans Comment récupérer à partir d’erreurs de canal USB.
Si l’appareil rencontre une erreur matérielle ou logicielle irrécupérable, le pilote client peut utiliser la fonction WdfDeviceSetFailed .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 11 |
| Serveur minimal pris en charge | Windows Server 2022 |
| Version UMDF minimale | 2,33 |
| En-tête | netadaptercx.h (inclure netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
Voir aussi
Récupération d’une carte réseau qui ne répond pas avec NetAdapterCx PLDR