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

Статья
08/07/2023

Важно!

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

Функция обратного вызова NdisWdiTxSendPauseIndication приостанавливает передачу данных на заданном порту в заданное одноранговое соединение или одноранговую комбинацию TID.

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

Синтаксис

NDIS_WDI_TX_SEND_PAUSE_IND NdisWdiTxSendPauseInd;

void NdisWdiTxSendPauseInd(
  [in] NDIS_HANDLE NdisMiniportDataPathHandle,
  [in] WDI_PORT_ID PortId,
  [in] WDI_PEER_ID PeerId,
  [in] UINT32 ExTidBitmask,
  [in] WDI_TX_PAUSE_REASON TxPauseReason
)
{...}

Параметры

[in] NdisMiniportDataPathHandle

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

[in] PortId

Идентификатор порта. Принимаются подстановочные знаки.

[in] PeerId

Идентификатор однорангового узла. Принимаются подстановочные знаки.

[in] ExTidBitmask

Битовая маска расширенного TID. Дополнительные сведения см. в разделе Примечания .

[in] TxPauseReason

Битовая маска причины приостановки TX, указанная как WDI_TX_PAUSE_REASON значения. Дополнительные сведения см. в разделе Примечания .

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

None

Remarks

В параметре ExTidBitmask^i-й бит представляет собой расширенный TID i (наименьший значимый бит — бит 0).

Битовая маска WDI_TX_PAUSE_REASON может содержать ряд причин приостановки. Причины приостановки являются совокупными, поэтому для NdisWdiTxSendPauseIndication с причиной приостановки WDI_TX_PAUSE_REASON_CREDIT за которой следует NdisWdiTxSendPauseIndication с причиной приостановки WDI_TX_PAUSE_REASON_IHV1 требует NdisWdiTxSendRestartIndication с причиной приостановки (WDI_TX_PAUSE_REASON_CREDIT | WDI_TX_PAUSE_REASON_IHV1) для набора очередей, который не будет размыкаться.

Если причина приостановки WDI_TX_PAUSE_REASON_PS, TAL/target не выдает NdisWdiTxSendRestartIndication любой из затронутых очередей, пока не получит уведомление MiniportWdiTxTalQueueInOrder для этой очереди.

Если параметр TargetPriorityQueueing имеет значение true, WDI_PEER_ID должен быть подстановочным знаком. В этом режиме разрешены только приостановки порта или адаптера.

Требования

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