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

Важно!

Этот раздел является частью модели драйвера 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