MINIPORT_WDI_TAL_TXRX_INITIALIZE callback function (dot11wdi.h)

  • Article

Important

This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features.

The MiniportWdiTalTxRxInitialize handler function initializes data structures in the TAL and exchanges datapath component handles between the UE and TAL. This is issued in the context of the driver initialization, and is issued prior to querying the firmware for the device capabilities.

This is a WDI miniport handler inside NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Note  You must declare the function by using the MINIPORT_WDI_TAL_TXRX_INITIALIZE type. For more information, see the following Examples section.
 

Syntax

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
)
{...}

Parameters

[in] MiniportAdapterContext

Handle for the IHV miniport context.

[in] NdisMiniportDataPathHandle

Handle for the IHV miniport to use in datapath indications.

[in] NdisWdiDataPathApi

Pointer to the WDI data API function table.

[out] pMiniportTalTxRxContext

The TAL device handle is a control path handle for the device (for example, MiniportContext). It is associated with the MiniportHandle, which used as context for NDIS API calls.

[in, out] pMiniportDataHandlers

The UE initializes the NDIS Header field so the LE can determine the revision and size that is safe to initialize according to traditional NDIS versioning rules. The LE is responsible for updating the Header with the revision and size that the LE actually implements and supports before returning.

[out] pMiniportWdiFrameMetadataExtraSpace

The LE sets the value pointed to by this parameter to the amount of space that WDI should reserve after the WDI_FRAME_METADATA for the LE to use.

Return value

Note  Non-NDIS_STATUS_SUCCESS return values indicate a generic failure.
 
Return code Description
NDIS_STATUS_SUCCESS
 Indicates that the miniport driver successfully exchanged datapath component handles.

Requirements

Requirement Value
Minimum supported client Windows 10
Minimum supported server Windows Server 2016
Target Platform Windows
Header dot11wdi.h

See also

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

TAL_TXRX_HANDLE

WDI general datapath interfaces

WDI_FRAME_METADATA