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

Статья
08/07/2023

Важно!

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

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

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

Примечание Функцию необходимо объявить с помощью типа MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE . Дополнительные сведения см. в следующем разделе Примеры.

Синтаксис

MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE MiniportWdiAdapterHangDiagnose;

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

Параметры

[in] MiniportDriverContext

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

[in] DiagnoseLevel

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

[in] BufferSize

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

[out] FirmwareBlob

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

[out] pOutputSize

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

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

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

Замечания

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 10
Минимальная версия сервера	Windows Server 2016
Целевая платформа	Windows
Header	dot11wdi.h

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

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

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

eDiagnoseLevel

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