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

Статья
08/07/2023

Важно!

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

Функция-обработчик MiniportWdiTxTalQueueInOrder уведомляет целевой объект TAL о том, что одна или несколько приостановленных очередей RA/TID (с WDI_TX_PAUSE_REASON_PS) готовы к передаче.

Это означает следующее:

В каждой из очередей нет необработанных кадров TX с TAL/target.
Все кадры, заполненные WDI_TxFrameStatus_SendPostponed , были вставлены в очередь RA-TID в правильном порядке.

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

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

Синтаксис

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MiniportWdiTxTalQueueInOrder;

void MiniportWdiTxTalQueueInOrder(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] WDI_PEER_ID PeerId,
  [in] UINT32 ExTidBitmask
)
{...}

Параметры

[in] MiniportTalTxRxContext

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

[in] PeerId

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

[in] ExTidBitmask

Битовая маска расширенного TID.

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

None

Remarks

TAL/target ожидает этого уведомления, прежде чем выдавать указание о перезапуске TX в приостановленной очереди с WDI_TX_PAUSE_REASON_PS.

Обратите вниманиеWDI_TxFrameStatus_SendPostponed не допускается, если targetPriorityQueueing имеет значение TRUE, поэтому этот запрос никогда не выполняется в этом режиме.

Примеры

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

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

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MyTxTalQueueInOrder;

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

_Use_decl_annotations_
VOID
 MyTxTalQueueInOrder(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PEER_ID PeerId,
    UINT32 ExTidBitmask
    )
  {...}

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

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

Требования

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