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

Статья
08/07/2023

Важно!

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

Функция обработчика MiniportWdiTalTxRxInitialize инициализирует структуры данных в TAL и обменивается дескрипторами компонента пути к данным между UE и TAL. Он выдается в контексте инициализации драйвера и выдается перед запросом встроенного ПО на наличие возможностей устройства.

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

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

Синтаксис

MINIPORT_WDI_TAL_TXRX_INITIALIZE MiniportWdiTalTxrxInitialize;

NDIS_STATUS MiniportWdiTalTxrxInitialize(
  [in]      NDIS_HANDLE MiniportAdapterContext,
  [in]      NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]      PNDIS_WDI_DATA_API NdisWdiDataPathApi,
  [out]     PTAL_TXRX_HANDLE pMiniportTalTxRxContext,
  [in, out] PNDIS_MINIPORT_WDI_DATA_HANDLERS pMiniportDataHandlers,
  [out]     UINT32 *pMiniportWdiFrameMetadataExtraSpace
)
{...}

Параметры

[in] MiniportAdapterContext

Дескриптор контекста мини-порта IHV.

[in] NdisMiniportDataPathHandle

Дескриптор для использования минипорта IHV в указаниях пути к данным.

[in] NdisWdiDataPathApi

Указатель на таблицу функций API данных WDI.

[out] pMiniportTalTxRxContext

Дескриптор устройства TAL — это дескриптор пути управления для устройства (например, MiniportContext). Он связан с MiniportHandle, который используется в качестве контекста для вызовов API NDIS.

[in, out] pMiniportDataHandlers

UE инициализирует поле заголовка NDIS, чтобы LE могли определить редакцию и размер, которые можно безопасно инициализировать в соответствии с традиционными правилами управления версиями NDIS. Le отвечает за обновление заголовка с помощью редакции и размера, которые le фактически реализует и поддерживает, прежде чем возвращать.

[out] pMiniportWdiFrameMetadataExtraSpace

Le задает значение, на которое указывает этот параметр, как объем пространства, который WDI должен зарезервировать после WDI_FRAME_METADATA для использования LE.

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

Примечание Не NDIS_STATUS_SUCCESS возвращаемые значения указывают на общий сбой.

Код возврата	Описание
NDIS_STATUS_SUCCESS	Указывает, что драйвер мини-порта успешно обменялся дескрипторами компонента пути к данным.

Требования

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

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

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

TAL_TXRX_HANDLE

Общие интерфейсы пути к данным WDI

WDI_FRAME_METADATA

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