NET_DEVICE_RESET_CAPABILITIES_INIT 函数 (netadaptercx.h)

NET_DEVICE_RESET_CAPABILITIES_INIT 函数初始化 NET_DEVICE_RESET_CAPABILITIES 结构。

语法

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

参数

[_Out_] ResetCapabilities

指向驱动程序分配 NET_DEVICE_RESET_CAPABILITIES 结构的指针。

[_In_] ResetDiagnosticsGuid

客户端驱动程序指定的全局唯一标识符(GUID)。 开发人员可以使用此标识符来检索重置诊断。 客户端驱动程序将重置诊断收集为设备重置和恢复过程中捕获的完整内核转储中的辅助数据。

[_In_] EvtNetDeviceCollectResetDiagnostics

指向客户端驱动程序实现的 EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS 回调的指针,该回调从硬件设备收集特定于设备的重置诊断。

返回值

没有

言论

客户端驱动程序通常在其 EVT_WDF_DRIVER_DEVICE_ADD 回调中调用 NET_DEVICE_RESET_CAPABILITIES_INIT

此函数将零出 NET_DEVICE_RESET_CAPABILITIES 结构,并填充其 大小 成员。 然后,它设置 ResetDiagnosticsGuid 成员,并使用相应的输入参数 EvtNetDeviceCollectResetDiagnostics 成员。

要求

要求 价值
最低支持的客户端 Windows 11
支持的最低服务器 Windows Server 2022
最低 UMDF 版本 2.33
标头 netadaptercx.h (包括 netadaptercx.h)
IRQL PASSIVE_LEVEL

另请参阅

使用 NetAdapterCx PLDR 恢复无响应 NIC

EVT_WDF_DRIVER_DEVICE_ADD

NET_DEVICE_RESET_CAPABILITIES

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS