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

Статья
08/07/2023

Важно!

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

Функция обработчика MiniportWdiTxTalSend задает очередь RA-TID или порта для передачи. TxMgr использует этот запрос вместо MiniportWdiTxDataSend для очередей RA-TID с расширенным TID в зарезервированном диапазоне IHV. Он выдается в контексте потока TX из операционной системы, указания возобновления или рабочего элемента.

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

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

Синтаксис

MINIPORT_WDI_TX_TAL_SEND MiniportWdiTxTalSend;

void MiniportWdiTxTalSend(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] WDI_PORT_ID PortId,
  [in] WDI_PEER_ID PeerId,
  [in] WDI_EXTENDED_TID ExTid,
  [in] UINT16 NumQueueFrames,
  [in] UINT32 NumActiveFrames,
  [in] BOOLEAN bRobustnessFlag
)
{...}

Параметры

[in] MiniportTalTxRxContext

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

[in] PortId

Идентификатор порта.

[in] PeerId

Идентификатор однорангового узла.

[in] ExTid

Расширенный TID.

[in] NumQueueFrames

Длина очереди в кадрах.

[in] NumActiveFrames

Общее количество кадров в действии (schedulable) очередей.

[in] bRobustnessFlag

Флаг надежности. Если для флага надежности задано значение TRUE, сетевой адаптер обеспечивает надежную доставку в рамках небольшого количества повторных попыток, активно снижая скорость передачи данных TX, используемую для кадра, с помощью CTS и (или) других механизмов.

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

None

Remarks

В режиме очереди портов для PeerId и ExTid заданы подстановочные знаки. В контексте запроса на отправку TxEngine выдает NdisWdiTxDequeueIndication , чтобы взять на себя владение рядом кадров из очереди FIFO RA-TID и передать их целевому объекту. Если не удается удалить кадры, TxEngine выдает NdisWdiTxSendPauseIndication в том же контексте, а не NdisWdiTxDequeueIndication.

TxEngine должен выдать полный перенос и отправить полные указания, чтобы вернуть права владения любыми кадрами, которые он отключает в TxMgr. Если завершение передачи содержит код сбоя, TxEngine не должен выдавать завершение отправки.

PeerId имеет подстановочный знак, если порт настроен в качестве точки доступа или владельца группы Wi-Fi Direct, а в качестве адреса получателя у кадра есть адрес группы.

При сбое TxEngine завершает передачу кадра в целевой объект с соответствующим состоянием сбоя.

Примеры

Чтобы определить функцию MiniportWdiTxTalSend, необходимо сначала предоставить объявление функции, определяющее тип определяемой функции. Windows предоставляет набор типов функций для драйверов. Объявление функции с помощью типов функций помогает анализу кода для драйверов, средству проверки статических драйверов (SDV) и другим средствам проверки находить ошибки, и это требование для написания драйверов для операционной системы Windows.

Например, чтобы определить функцию MiniportWdiTxTalSend с именем MyTxTalSend, используйте тип MINIPORT_WDI_TX_TAL_SEND , как показано в следующем примере кода:

MINIPORT_WDI_TX_TAL_SEND MyTxTalSend;

Затем реализуйте функцию следующим образом:

_Use_decl_annotations_
VOID
 MyTxTalSend(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PORT_ID PortId,
    WDI_PEER_ID PeerId,
    WDI_EXTENDED_TID ExTid,
    UINT16 NumQueueFrames,
    UINT32 NumActiveFrames,
    BOOLEAN bRobustnessFlag
    )
  {...}

Тип функции MINIPORT_WDI_TX_TAL_SEND определен в файле заголовка dot11wdi.h. Чтобы более точно определить ошибки при запуске средств анализа кода, не забудьте добавить заметку Use_decl_annotations в определение функции. Заметка Use_decl_annotations гарантирует использование заметок, которые применяются к типу функции MINIPORT_WDI_TX_TAL_SEND в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в статье Объявление функций с помощью типов ролей функций для драйверов NDIS.

Сведения о Use_decl_annotations см. в статье Поведение функции с заметками.

Требования

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