Функция NetDeviceStoreResetDiagnostics (netadaptercx.h)

Статья
02/29/2024

Функция NetDeviceStoreResetDiagnostics сохраняет собранные диагностика сброса драйвера клиента в платформу NetAdapterCx.

Синтаксис

void NetDeviceStoreResetDiagnostics(
  [_In_]                                   WDFDEVICE   Device,
  [_In_]                                   SIZE_T      ResetDiagnosticsSize,
  [_In_reads_bytes_(ResetDiagnosticsSize)] const UINT8 *ResetDiagnosticsBuffer
);

Параметры

[_In_] Device

Объект WDFDEVICE, ранее созданный драйвером клиента с помощью вызова WdfDeviceCreate.

[_In_] ResetDiagnosticsSize

Размер элемента ResetDiagnosticsBuffer в байтах. Максимальный размер сброса диагностика, который принимает платформа, составляет 1 МБ.

[_In_reads_bytes_(ResetDiagnosticsSize)] ResetDiagnosticsBuffer

Указатель на буфер данных, содержащий данные сброса диагностика. Буфер данных может поступать из страничного или нестраничного пула.

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

None

Remarks

Единственным допустимым сценарием для вызова функции NetDeviceStoreResetDiagnostics является обратный вызов EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS драйвера клиента. Драйвер клиента должен вызывать NetDeviceStoreResetDiagnostics по адресу PASSIVE_LEVEL

Сведения о том, как правильно использовать функцию NetDeviceStoreResetDiagnostics , см. в статье Реализация EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS.

Требования

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

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

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

WdfDeviceCreate

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS

Поделиться через