MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 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 MiniportWdiTxTalQueueInOrder notifica alla destinazione TAL che una o più code RA/TID sospese (con WDI_TX_PAUSE_REASON_PS) sono pronte per la trasmissione.

Ciò significa:

Ognuna delle code non ha frame TX in sospeso con TAL/destinazione.
Tutti i fotogrammi completati con WDI_TxFrameStatus_SendPostponed sono stati inseriti nella coda RA-TID nell'ordine corretto.

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_TAL_QUEUE_IN_ORDER . Per altre informazioni, vedere la sezione Esempi seguente.

Sintassi

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MiniportWdiTxTalQueueInOrder;

void MiniportWdiTxTalQueueInOrder(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] WDI_PEER_ID PeerId,
  [in] UINT32 ExTidBitmask
)
{...}

Parametri

[in] MiniportTalTxRxContext

Handle del dispositivo TAL restituito dal miniport IHV in MiniportWdiTalTxRxInitialize.

[in] PeerId

ID peer.

[in] ExTidBitmask

Maschera di bit TID estesa.

Valore restituito

nessuno

Osservazioni

Il tal/destinazione attende questa notifica prima di inviare un'indicazione di riavvio TX a una coda sospesa con WDI_TX_PAUSE_REASON_PS.

NotaWDI_TxFrameStatus_SendPostponed non è consentito quando TargetPriorityQueueing è TRUE, quindi questa richiesta non viene mai effettuata quando è in tale modalità.

Esempio

Per definire una funzione MiniportWdiTxTalQueueInOrder, è 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 MiniportWdiTxTalQueueInOrder denominata "MyTxTalQueueInOrder", usare il tipo MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER , come illustrato nell'esempio di codice seguente:

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MyTxTalQueueInOrder;

Implementare quindi la funzione come segue:

_Use_decl_annotations_
VOID
 MyTxTalQueueInOrder(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PEER_ID PeerId,
    UINT32 ExTidBitmask
    )
  {...}

Il tipo di funzione MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER è 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_TAL_QUEUE_IN_ORDER 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.