функция обратного вызова MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE (dot11wificxintf.h)

Статья
02/06/2025

Важный

Этот раздел является частью модели драйвера WiFiCx. WiFiCx — это модель драйвера Wi-Fi, выпущенная в Windows 11. Мы рекомендуем использовать WiFiCx для использования новейших функций. Предыдущая модель драйвера Wi-Fi WDI находится в режиме обслуживания и будет получать только исправления с высоким приоритетом.

Функция обработчика MiniportWdiAdapterHangDiagnose используется для сбора состояний регистра оборудования и при необходимости полного состояния встроенного ПО.

Это обработчик мини-порта WDI внутри NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Заметка

Необходимо объявить функцию с помощью типа MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE.

Синтаксис

MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE MiniportWdiAdapterHangDiagnose;

NDIS_STATUS MiniportWdiAdapterHangDiagnose(
  NDIS_HANDLE MiniportDriverContext,
  eDiagnoseLevel DiagnoseLevel,
  UINT32 BufferSize,
  UINT8 *FirmwareBlob,
  UINT32 *pOutputSize
)
{...}

Параметры

MiniportDriverContext

[in] Дескриптор области контекста, выделенной драйвером, где драйвер хранит сведения о состоянии и конфигурации. Минипорт-драйвер передал эту область контекста функции NdisMRegisterWdiMiniportDriver.

DiagnoseLevel

[in] Уровень диагностики, как определено в перечислении eDiagnoseLevel. Уровень по умолчанию — DiagnoseLevelHardwareRegisters, максимум 1 КБ в выходном буфере.

BufferSize

[in] Размер FirmwareBlobв байтах.

FirmwareBlob

[out] Указатель на буфер, который будет содержать состояния реестра аппаратных элементов управления и при необходимости полный состояние встроенного ПО.

pOutputSize

[out] Указатель на число байтов, записанных в FirmwareBlob.

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

Возвращаемое значение игнорируется.

Замечания

Уровень диагностики по умолчанию — DiagnoseLevelHardwareRegistersс максимальным размером 1 КБ в выходном буфере.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 11
минимальный поддерживаемый сервер	Windows Server 2022
заголовка	dot11wificxintf.h

См. также

WDI обнаружение и восстановление

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

eDiagnoseLevel

NdisMRegisterWdiMiniportDriver

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