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

Статья
02/23/2024

Важно!

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

Функция обратного вызова NdisWdiTxDequeueIndication вызывается в контексте miniportWdiTxDataSend или MiniportWdiTxTalSend минипортом IHV для вывода кадров из WDI в минипорт IHV.

Это обратный вызов внутри NDIS_WDI_DATA_API.

Синтаксис

NDIS_WDI_TX_DEQUEUE_IND NdisWdiTxDequeueInd;

void NdisWdiTxDequeueInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  UINT32 Quantum,
  [in]  UINT8 MaxNumFrames,
  [in]  UINT16 Credit,
  [out] PNET_BUFFER_LIST *ppNBL
)
{...}

Параметры

[in] NdisMiniportDataPathHandle

NdisMiniportDataPathHandle, переданный в минипорт IHV в MiniportWdiTalTxRxInitialize.

[in] Quantum

Квант. Дополнительные сведения см. в разделе Планирование передачи узла — целевого объекта TX статьи Путь WDI TX.

[in] MaxNumFrames

Максимальное число кадров.

[in] Credit

Стоимость кредита. Дополнительные сведения см. в разделе Схема целевого кредита и механизм приостановки и возобновления в пути WDI TX.

[out] ppNBL

Указатель на указатель на цепочку NET_BUFFER_LIST , выведенную из очереди WDI.

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

None

Remarks

Подмножество параметров может быть неприменимо к устройству. Например, максимальное число кадров может не применяться к хранилищу и устройству пересылки (интерфейс шины на основе сообщений).

При таких обстоятельствах TxMgr игнорирует следующие параметры.

Quantum , если задано значение WDI_TX_QUANTUM_INVALID (0xFFFFFFFF)
MaxNumFrames, если задано значение WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF)
Кредит , если задано значение WDI_TX_CREDIT_INVALID (0xFFFF)

TAL должен по возможности предоставлять точные параметры, чтобы гарантировать справедливость и избежать перегрузки ресурсов TIL/целевых ресурсов.

Если у TAL недостаточно кредитов для вывода из очереди кадра максимальной стоимости, он должен выдать NdisWdiTxSendPauseIndication вместо NdisWdiTxDequeueIndication.

TxMgr может возвращать список NET_BUFFER_LIST , превышающих предельное количество кадров, стоимость кадра или квантовую величину. Это происходит только в том случае, если кадры перезапускаются или воспроизводится после завершения отправки с состоянием Отложено и с одинаковым порядковый номер, который указывает, что они были изначально переданы как часть одного A-MSDU.

Требования

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

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

NDIS_WDI_DATA_API

NET_BUFFER_LIST

NdisWdiTxDequeueIndication

NdisWdiTxSendPauseIndication

Путь WDI TX

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