NetDeviceRequestReset, fonction (netadaptercx.h)

  • Article

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
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

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES