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 结构归零并填充其 Size 成员。 然后使用相应的输入参数设置 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