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

  • Статья

Важно!

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

Функция обратного вызова TxSuspectFrameListAbort реализуется минипортом IHV, чтобы сообщить TxEngine о том, что TxMgr определил кадры, которые подозреваются в том, что они зависают или ожидают завершения в течение значительного времени.

Синтаксис

MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT MiniportWdiTxSuspectFrameListAbort;

void MiniportWdiTxSuspectFrameListAbort(
  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  UINT64 SuspectFrameContext,
  UINT16 NumSuspectFrames,
  PNET_BUFFER_LIST *SuspectFrameList
)
{...}

Параметры

MiniportTalTxRxContext

Дескриптор устройства TAL, возвращаемый минипортом IHV в MiniportWdiTalTxRxInitialize.

SuspectFrameContext

Контекстная информация о предполагаемом кадре.

NumSuspectFrames

Количество подозрительных кадров.

SuspectFrameList

Список подозрительных кадров. Дополнительные сведения см. в разделе «Примечания».

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

None

Remarks

Зарегистрируйте реализацию этой функции обратного вызова, задав соответствующий член структуры NDIS_MINIPORT_WDI_DATA_HANDLERS .

Это необязательный обработчик. Если минипорт IHV не реализует поведение этого обратного вызова, он не должен задавать указатель функции в NDIS_MINIPORT_WDI_DATA_HANDLERS и WDI не будет вызывать этот обработчик. Однако если поведение этого обратного вызова не реализовано, указатель функции может быть по-прежнему задан, если минипорт IHV использует SuspectFrameList для регистрации состояния IHV в целях диагностики.

Эта функция обратного вызова сообщает TxEngine, что TxMgr определил кадры, которые подозреваются в том, что они зависают или ожидают завершения в течение значительного периода времени. Массив SuspectFrameList указателей NBL, для которых указатель Next неприменим, представляет кадры, которые TxMgr запрашивает, даже если это приводит к тому, что кадр не передается по воздуху.

TxEngine может проверка состояние NBL в массиве SuspectFrameList путем вызова TxQuerySuspectFrameStatus из контекста TxSuspectFrameListAbort с suspectFrameContext, переданным обработчику. TxMgr не будет вызывать TxTargetDescDeinit для каких-либо NBL в SuspectFrameList в течение срока действия TxSuspectFrameAbort, а также не будет завершать кадры в NDIS.

Если TxEngine или встроенное ПО не имеет сведений или состояния для подозрительного кадра, он не должен выполнять завершения для этого подозрительного кадра, так как это может привести к повреждению системы и /или двойному завершению.

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

Требования

Требование Значение
Заголовок dot11wdi.h