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 appareil de carte réseau non réactive.

Syntaxe

void NetDeviceRequestReset(
  [_In_] WDFDEVICE Device
);

Paramètres

[_In_] Device

Objet WDFDEVICE créé précédemment avec un appel à WdfDeviceCreate.

Valeur de retour

Aucun

Remarques

Un pilote client appelle NetDeviceRequestReset lorsqu’il détecte l’échec 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 les travaux en cours qui accèdent à l’appareil en cours d’échec.

Nous vous recommandons de configurer une structure de NET_DEVICE_RESET_CAPABILITIES pour collecter des diagnostics de réinitialisation significatifs 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 de collecte de diagnostics facultatif.

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.

Exigences

Voir aussi

récupération d’une carte réseau sans réponse avec NetAdapterCx PLDR

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES