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

Статья
08/07/2023

Важно!

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

Функция-обработчик MiniportWdiTxAbort прерывает незавершенные кадры TX для заданного порта или однорангового узла, что включает в себя инициализацию завершения кадров, принадлежащих TAL/target. Этот запрос отправляется в TAL в рамках обработки MiniportPause (прерывание TX на уровне адаптера), сброс dot11 (прерывание на уровне порта) и после NdisWdiPeerDeleteIndication , если WDI работает в одноранговом режиме очередей.

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

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

Синтаксис

MINIPORT_WDI_TX_ABORT MiniportWdiTxAbort;

void MiniportWdiTxAbort(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Параметры

[in] MiniportTalTxRxContext

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

[in] PortId

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

[in] PeerId

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

[out] pWifiStatus

Указатель на состояние MiniportWdiTxAbort, которое должно быть задано минипортом IHV. Дополнительные сведения см. в разделе Примечания .

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

None

Remarks

Для PeerId можно указать подстановочный знак, чтобы остановить TX на порту.

Чтобы остановить TX в адаптере, можно указать подстановочные знаки для PortId и PeerId .

Чтобы завершить операцию остановки, TAL должен выполнить следующие действия.

Инициируйте возврат прав владения буферами данных TX, соответствующими входным параметрам узла. Эти кадры должны быть завершены путем указания завершения передачи для всех кадров, переданных в TxEngine в запросах на отправку, и указания NdisWdiTxSendCompleteIndication для необработанных кадров TX, требующих явного завершения отправки (если кадр TX не был завершен с кодом успешного выполнения).
Возврат состояния успешного выполнения или состояние ожидания и выдача NdisWdiTxAbortConfirm позже.

Примеры

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

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

MINIPORT_WDI_TX_ABORT MyTxAbort;

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

_Use_decl_annotations_
VOID
 MyTxAbort(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PORT_ID PortId,
    WDI_PEER_ID PeerId,
    NDIS_STATUS *pWifiStatus
    )
  {...}

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

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

Требования

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