Freigeben über


NET_DEVICE_RESET_CAPABILITIES_INIT-Funktion (netadaptercx.h)

Die NET_DEVICE_RESET_CAPABILITIES_INIT-Funktion initialisiert eine NET_DEVICE_RESET_CAPABILITIES-Struktur .

Syntax

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

Parameter

[_Out_] ResetCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene NET_DEVICE_RESET_CAPABILITIES-Struktur .

[_In_] ResetDiagnosticsGuid

Ein Clienttreiber hat die GUID (Global Unique Identifier) angegeben. Entwickler können diesen Bezeichner verwenden, um zurückgesetzte Diagnose abzurufen. Der Clienttreiber sammelt die zurückgesetzten Diagnose als sekundäre Daten im vollständigen Kernelabbild, das beim Zurücksetzen und Wiederherstellen des Geräts erfasst wird.

[_In_] EvtNetDeviceCollectResetDiagnostics

Ein Zeiger auf die Implementierung des EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS Rückrufs durch den Clienttreiber, der gerätespezifische zurückgesetzte Diagnose von einem Hardwaregerät erfasst.

Rückgabewert

Keine

Bemerkungen

Ein Clienttreiber ruft in der Regel NET_DEVICE_RESET_CAPABILITIES_INIT in seinem EVT_WDF_DRIVER_DEVICE_ADD-Rückruf auf.

Diese Funktion stellt die NET_DEVICE_RESET_CAPABILITIES-Struktur auf null und füllt ihren Size-Member aus. Anschließend werden die Member ResetDiagnosticsGuid und EvtNetDeviceCollectResetDiagnostics mit den entsprechenden Eingabeparametern festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11
Unterstützte Mindestversion (Server) Windows Server 2022
UMDF-Mindestversion 2.33
Kopfzeile netadaptercx.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

Wiederherstellen einer nicht reagierenden NIC mit NetAdapterCx PLDR

EVT_WDF_DRIVER_DEVICE_ADD

NET_DEVICE_RESET_CAPABILITIES

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS