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

Статья
08/07/2023

Важно!

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

Функция обратного вызова MINIPORT_WDI_TX_TARGET_DESC_INIT связывает непрозрачный целевой дескриптор TX с NET_BUFFER_LIST (поле MiniportReserved[1] ) и (если применимо) заполняет поле затрат TX (в единицах кредита) в буфере WDI_FRAME_METADATANET_BUFFER_LIST (MiniportReserved[0]).

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

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

Синтаксис

MINIPORT_WDI_TX_TARGET_DESC_INIT MiniportWdiTxTargetDescInit;

void MiniportWdiTxTargetDescInit(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  PNET_BUFFER_LIST pNBL,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Параметры

[in] MiniportTalTxRxContext

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

[in] pNBL

Указатель на один NET_BUFFER_LIST.

[out] pWifiStatus

Указатель на состояние, заданное IHV, чтобы указать результат функции обратного вызова MINIPORT_WDI_TX_TARGET_DESC_INIT .

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

None

Remarks

Состояние NDIS_STATUS_RESOURCES следует использовать только при исчерпании дескрипторов Tx. Лучшее поведение происходит, если мини-порт IHV не использует NDIS_STATUS_RESOURCES. Для любой другой ошибки, указывающей, что минипорт или встроенное ПО IHV не могут обработать NET_BUFFER_LIST, необходимо использовать любое состояние, отличное от NDIS_STATUS_SUCCESS и NDIS_STATUS_RESOURCES.

Минипорт IHV может использовать обратную заполнение в NET_BUFFER с помощью соответствующих функций NDIS retreat и advance. Начало смещения пакета должно быть восстановлено до или в функции обратного вызова MINIPORT_WDI_TX_TARGET_DESC_DEINIT . TxMgr определяет длину кадра во время вывода из очереди, поэтому любое изменение длины кадра в функции обратного вызова MINIPORT_WDI_TX_TARGET_DESC_INIT включается в ограничение размера вывода в квант. В этом случае минипорт IHV должен соответствующим образом настроить квантовую учесть разницу.

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

Примеры

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

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

MINIPORT_WDI_TX_TARGET_DESC_INIT MyTxTargetDescInit;

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

_Use_decl_annotations_
VOID
 MyTxTargetDescInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL,
    NDIS_STATUS *pWifiStatus
    )
  {...}

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

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

Требования

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