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

Статья
08/07/2023

Важно!

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

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

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

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

Синтаксис

MINIPORT_WDI_TX_DATA_SEND MiniportWdiTxDataSend;

void MiniportWdiTxDataSend(
  [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

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

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

Примеры

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

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

MINIPORT_WDI_TX_DATA_SEND MyTxDataSend;

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

_Use_decl_annotations_
VOID
 MyTxDataSend(
    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_DATA_SEND определен в файле заголовка dot11wdi.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте заметку Use_decl_annotations в определение функции. Заметка Use_decl_annotations гарантирует использование заметок, которые применяются к типу функции MINIPORT_WDI_TX_DATA_SEND в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в разделе Объявление функций с помощью типов ролей функций для драйверов NDIS.

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

Требования

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