MINIPORT_WDI_TAL_TXRX_INITIALIZE funzione di callback (dot11wdi.h)

Articolo
08/07/2023

Importante

Questo argomento fa parte del modello di driver WDI rilasciato in Windows 10. Il modello di driver WDI è in modalità di manutenzione e riceverà solo correzioni con priorità elevata. WiFiCx è il modello di driver Wi-Fi rilasciato in Windows 11. Ti consigliamo di usare WiFiCx per sfruttare le funzionalità più recenti.

La funzione del gestore MiniportWdiTalTxRxInitialize inizializza le strutture di dati nel tal e scambia gli handle dei percorsi dati tra UE e TAL. Questo viene rilasciato nel contesto dell'inizializzazione del driver e viene rilasciato prima di eseguire query sul firmware per le funzionalità del dispositivo.

Si tratta di un gestore miniport WDI all'interno di NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Nota È necessario dichiarare la funzione usando il tipo di MINIPORT_WDI_TAL_TXRX_INITIALIZE . Per altre informazioni, vedere la sezione Esempi seguente.

Sintassi

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

Parametri

[in] MiniportAdapterContext

Handle per il contesto del miniport IHV.

[in] NdisMiniportDataPathHandle

Handle per il miniport IHV da usare nelle indicazioni del percorso dati.

[in] NdisWdiDataPathApi

Puntatore alla tabella delle funzioni dell'API dati WDI.

[out] pMiniportTalTxRxContext

L'handle del dispositivo TAL è un handle di percorso di controllo per il dispositivo ,ad esempio MiniportContext. È associato a MiniportHandle, usato come contesto per le chiamate API NDIS.

[in, out] pMiniportDataHandlers

L'UE inizializza il campo Intestazione NDIS in modo che l'oggetto LE possa determinare la revisione e le dimensioni che è possibile inizializzare in modo sicuro in base alle regole di controllo delle versioni NDIS tradizionali. L'elemento LE è responsabile dell'aggiornamento dell'intestazione con la revisione e le dimensioni effettivamente implementate e supportate da LE prima della restituzione.

[out] pMiniportWdiFrameMetadataExtraSpace

L'oggetto LE imposta il valore a cui punta questo parametro alla quantità di spazio che WDI deve riservare dopo il WDI_FRAME_METADATA per l'utilizzo dell'oggetto LE.