MINIPORT_WDI_TX_TARGET_DESC_DEINIT 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. È consigliabile usare WiFiCx per sfruttare le funzionalità più recenti.

La funzione di callback MINIPORT_WDI_TX_TARGET_DESC_DEINIT informa il TxEngine che i descrittori TX di destinazione associati ai NET_BUFFER_LIST (NBLs) nella catena NBL non sono più necessari e possono essere liberati.

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

Sintassi

MINIPORT_WDI_TX_TARGET_DESC_DEINIT MiniportWdiTxTargetDescDeinit;

void MiniportWdiTxTargetDescDeinit(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] PNET_BUFFER_LIST pNBL
)
{...}

Parametri

[in] MiniportTalTxRxContext

Handle del dispositivo TAL restituito dal miniport IHV nella funzione di callback MINIPORT_WDI_TAL_TXRX_INITIALIZE.

[in] pNBL

Puntatore a una catena di NET_BUFFER_LIST .

Valore restituito

nessuno

Osservazioni

Importante Il miniport IHV non è autorizzato a fare alcuna indicazione nel contesto di questa chiamata. TxMgr serializza le chiamate a TxTargetDescDeInitHandler.

Esempio

Per definire una funzione di callback MINIPORT_WDI_TX_TARGET_DESC_DEINIT , è prima necessario specificare 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 usando i tipi di funzione consente l'analisi del codice per i driver, il verifica driver statico (SDV) e altri strumenti di verifica trovano errori ed è un requisito per la scrittura di driver per il sistema operativo Windows.

Ad esempio, per definire una funzione di callback MINIPORT_WDI_TX_TARGET_DESC_DEINIT denominata "MyTxTargetDescDeInit", usare il tipo di MINIPORT_WDI_TX_TARGET_DESC_DEINIT come illustrato in questo esempio di codice:

MINIPORT_WDI_TX_TARGET_DESC_DEINIT MyTxTargetDescDeInit;

Implementare quindi la funzione come indicato di seguito:

_Use_decl_annotations_
VOID
 MyTxTargetDescDeInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL
    )
  {...}

Il tipo di funzione MINIPORT_WDI_TX_TARGET_DESC_DEINIT è definito nel file di intestazione dot11wdi.h. Per identificare in modo più accurato gli errori durante l'esecuzione degli 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 usate le annotazioni applicate al tipo di funzione MINIPORT_WDI_TX_TARGET_DESC_DEINIT nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite tipi di ruolo per i driver NDIS.

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