функция NET_DEVICE_RESET_CAPABILITIES_INIT (netadaptercx.h)

Статья
08/07/2023

Функция 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, который собирает диагностика сброса с аппаратного устройства.

Возвращаемое значение

None

Remarks

Драйвер клиента обычно вызывает NET_DEVICE_RESET_CAPABILITIES_INIT при обратном вызове EVT_WDF_DRIVER_DEVICE_ADD .

Эта функция обнуляет структуру NET_DEVICE_RESET_CAPABILITIES и заполняет ее элемент Size . Затем он задает член ResetDiagnosticsGuid и элемент EvtNetDeviceCollectResetDiagnostics с соответствующими входными параметрами.

Требования

Требование	Значение
Минимальная версия клиента	Windows 11
Минимальная версия сервера	Windows Server 2022
Верхняя часть	netadaptercx.h (включая netadaptercx.h)
IRQL	PASSIVE_LEVEL

См. также раздел

Восстановление сетевого адаптера, не отвечающего на запросы, с помощью NetAdapterCx PLDR

EVT_WDF_DRIVER_DEVICE_ADD

NET_DEVICE_RESET_CAPABILITIES

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS