MINIPORT_WDI_TX_DATA_SEND funzione di callback (dot11wdi.h)

Articolo
02/26/2024

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 MiniportWdiTxDataSend specifica una coda ra-TID o una coda di porte da cui trasmettere. Viene emesso nel contesto del thread TX dal sistema operativo, dall'indicazione di ripresa o da un elemento di lavoro.

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

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

Sintassi

MINIPORT_WDI_TX_DATA_SEND MiniportWdiTxDataSend;

void MiniportWdiTxDataSend(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] WDI_PORT_ID PortId,
  [in] WDI_PEER_ID PeerId,
  [in] WDI_EXTENDED_TID ExTid,
  [in] UINT16 NumQueueFrames,
  [in] UINT32 NumActiveFrames,
  [in] BOOLEAN bRobustnessFlag
)
{...}

Parametri

[in] MiniportTalTxRxContext

Handle del dispositivo TAL restituito dal miniport IHV in MiniportWdiTalTxRxInitialize.

[in] PortId

ID porta.

[in] PeerId

ID peer.

[in] ExTid

TID esteso.

[in] NumQueueFrames

Lunghezza della coda, in fotogrammi.

[in] NumActiveFrames

Numero totale di fotogrammi nelle code di azione (pianificabili).

[in] bRobustnessFlag

Flag di affidabilità. Se il flag di affidabilità è impostato su TRUE, la scheda di interfaccia di rete garantisce un recapito affidabile entro un numero ridotto di tentativi riducendo in modo aggressivo la velocità dei dati TX usata per il frame usando CTS e/o altri meccanismi.

Valore restituito

nessuno

Osservazioni

In modalità di accodamento delle porte, le WDI_PEER_ID e le WDI_EXTENDED_TID sono impostate su caratteri jolly. Nel contesto della richiesta di invio, TxEngine rilascia NdisWdiTxDequeueIndication per acquisire la proprietà di un numero di fotogrammi dalla coda FIFO RA-TID e trasferirli alla destinazione. Se non è possibile rimuovere dalla coda alcun frame, il TxEngine genera NdisWdiTxSendPauseIndication nello stesso contesto anziché NdisWdiTxDequeueIndication.

TxEngine deve emettere un trasferimento completo e inviare indicazioni complete per restituire la proprietà di tutti i frame che dequeue a TxMgr. Se il trasferimento completo contiene un codice di errore, TxEngine non deve emettere un completamento di invio.

Esempio

Per definire una funzione MiniportWdiTxDataSend, è innanzitutto necessario fornire una dichiarazione di funzione che identifica il tipo di funzione che si sta definendo. Windows fornisce un set di tipi di funzione per i driver. La dichiarazione di una funzione con i tipi di funzione consente di eseguire l'analisi del codice per i driver, l'SDV ( Static Driver Verifier ) e altri strumenti di verifica rilevano gli errori ed è un requisito per la scrittura dei driver per il sistema operativo Windows.

Ad esempio, per definire una funzione MiniportWdiTxDataSend denominata "MyTxDataSend", usare il tipo di MINIPORT_WDI_TX_DATA_SEND come illustrato nell'esempio di codice seguente:

MINIPORT_WDI_TX_DATA_SEND MyTxDataSend;

Implementare quindi la funzione come segue:

_Use_decl_annotations_
VOID
 MyTxDataSend(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PORT_ID PortId,
    WDI_PEER_ID PeerId,
    WDI_EXTENDED_TID ExTid,
    UINT16 NumQueueFrames,
    UINT32 NumActiveFrames,
    BOOLEAN bRobustnessFlag
    )
  {...}

Il tipo di funzione MINIPORT_WDI_TX_DATA_SEND è definito nel file di intestazione dot11wdi.h. Per identificare in modo più accurato gli errori quando si eseguono gli strumenti di analisi del codice, assicurarsi di aggiungere l'annotazione Use_decl_annotations alla definizione della funzione. L'annotazione Use_decl_annotations garantisce che vengano utilizzate le annotazioni applicate al tipo di funzione MINIPORT_WDI_TX_DATA_SEND nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite tipi di ruolo di funzione per i driver NDIS.

Per informazioni sulle Use_decl_annotations, vedere Annotazione del comportamento della funzione.