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

Статья
02/06/2025

Важный

Этот раздел является частью модели драйвера 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 для использования в указаниях datapath.

[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	Указывает, что минипорт-драйвер успешно обменивается компонентами datapath.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
заголовка	dot11wdi.h

См. также

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

TAL_TXRX_HANDLE

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

WDI_FRAME_METADATA

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