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

Статья
02/06/2025

Важный

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

Квантовый. Дополнительные сведения см. в разделе Host — target TX transfer scheduling в пути WDI TX.

[in] MaxNumFrames

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

[in] Credit

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

[out] ppNBL

Указатель на указатель на цепочку NET_BUFFER_LIST, отложенную WDI.

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

Никакой

Замечания

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

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

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

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
заголовка	dot11wdi.h

См. также

NDIS_WDI_DATA_API

NET_BUFFER_LIST

NdisWdiTxDequeueIndication

NdisWdiTxSendPauseIndication

пути WDI TX

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