Partager via


fonction NET_DEVICE_RESET_CAPABILITIES_INIT (netadaptercx.h)

La fonction NET_DEVICE_RESET_CAPABILITIES_INIT initialise une structure NET_DEVICE_RESET_CAPABILITIES.

Syntaxe

void NET_DEVICE_RESET_CAPABILITIES_INIT(
  [_Out_] NET_DEVICE_RESET_CAPABILITIES            *ResetCapabilities,
  [_In_]  GUID                                     ResetDiagnosticsGuid,
  [_In_]  PFN_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS EvtNetDeviceCollectResetDiagnostics
);

Paramètres

[_Out_] ResetCapabilities

Pointeur vers une structure NET_DEVICE_RESET_CAPABILITIES allouée par le pilote.

[_In_] ResetDiagnosticsGuid

Un pilote client a spécifié un identificateur unique global (GUID). Les développeurs peuvent utiliser cet identificateur pour récupérer les diagnostics de réinitialisation. Le pilote client collecte les diagnostics de réinitialisation en tant que données secondaires dans le vidage du noyau complet capturé dans le processus de réinitialisation et de récupération de l’appareil.

[_In_] EvtNetDeviceCollectResetDiagnostics

Pointeur vers l’implémentation du pilote client du rappel EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS qui collecte les diagnostics de réinitialisation spécifiques à l’appareil à partir d’un appareil matériel.

Valeur de retour

Aucun

Remarques

Un pilote client appelle généralement NET_DEVICE_RESET_CAPABILITIES_INIT dans son rappel EVT_WDF_DRIVER_DEVICE_ADD.

Cette fonction supprime la structure NET_DEVICE_RESET_CAPABILITIES et remplit son membre Size. Ensuite, il définit le membre ResetDiagnosticsGuid et EvtNetDeviceCollectResetDiagnostics membre avec les paramètres d’entrée correspondants.

Exigences

Exigence Valeur
client minimum pris en charge Windows 11
serveur minimum pris en charge Windows Server 2022
version minimale de UMDF 2.33
d’en-tête netadaptercx.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL

Voir aussi

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

EVT_WDF_DRIVER_DEVICE_ADD

NET_DEVICE_RESET_CAPABILITIES

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS