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

Статья
08/07/2023

Важно!

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

Функция обратного вызова MINIPORT_WDI_TX_TARGET_DESC_DEINIT сообщает TxEngine, что целевые дескрипторы TX, связанные с NET_BUFFER_LIST (NBL) в цепочке NBL, больше не нужны и могут быть освобождены.

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

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

Синтаксис

MINIPORT_WDI_TX_TARGET_DESC_DEINIT MiniportWdiTxTargetDescDeinit;

void MiniportWdiTxTargetDescDeinit(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] PNET_BUFFER_LIST pNBL
)
{...}

Параметры

[in] MiniportTalTxRxContext

Дескриптор устройства TAL, возвращаемый минипортом IHV в функции обратного вызова MINIPORT_WDI_TAL_TXRX_INITIALIZE .

[in] pNBL

Указатель на цепочку NET_BUFFER_LIST .

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

None

Remarks

Важно Минипорту IHV не разрешено делать какие-либо указания в контексте этого вызова. TxMgr сериализует вызовы TxTargetDescDeInitHandler.

Примеры

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

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

MINIPORT_WDI_TX_TARGET_DESC_DEINIT MyTxTargetDescDeInit;

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

_Use_decl_annotations_
VOID
 MyTxTargetDescDeInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL
    )
  {...}

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

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

Требования

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

См. также раздел

NDIS_MINIPORT_WDI_DATA_HANDLERS

NET_BUFFER_LIST

TAL_TXRX_HANDLE

Путь WDI TX

Поделиться через