MINIPORT_WDI_TX_TARGET_DESC_INIT 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 di callback MINIPORT_WDI_TX_TARGET_DESC_INIT associa un descrittore TX opaco alla NET_BUFFER_LIST (campo MiniportReserved[1] e (se applicabile) popola il campo costo TX (in unità di credito) nel buffer WDI_FRAME_METADATA del NET_BUFFER_LIST (MiniportReserved[0]).

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

Sintassi

MINIPORT_WDI_TX_TARGET_DESC_INIT MiniportWdiTxTargetDescInit;

void MiniportWdiTxTargetDescInit(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  PNET_BUFFER_LIST pNBL,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Parametri

[in] MiniportTalTxRxContext

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

[in] pNBL

Puntatore a un singolo NET_BUFFER_LIST.

[out] pWifiStatus

Puntatore allo stato impostato dall'IHV per indicare il risultato della funzione di callback MINIPORT_WDI_TX_TARGET_DESC_INIT.

Valore restituito

nessuno

Osservazioni

Uno stato di NDIS_STATUS_RESOURCES deve essere utilizzato solo quando i descrittori Tx sono esauriti. Il comportamento migliore si verifica se il miniport IHV non usa NDIS_STATUS_RESOURCES. Qualsiasi stato diverso da NDIS_STATUS_SUCCESS e NDIS_STATUS_RESOURCES deve essere utilizzato per qualsiasi altro errore che indica che il miniport O firmware IHV non è in grado di elaborare il NET_BUFFER_LIST.

Il miniport IHV può utilizzare il riempimento nel NET_BUFFER utilizzando le funzioni di ritiro e avanzamento NDIS appropriate. L'inizio dell'offset del pacchetto deve essere ripristinato prima o nella funzione di callback MINIPORT_WDI_TX_TARGET_DESC_DEINIT . TxMgr determina la lunghezza del frame durante il tempo di rimozione dalla coda, in modo che qualsiasi modifica alla lunghezza del fotogramma nella funzione di callback MINIPORT_WDI_TX_TARGET_DESC_INIT sia inclusa nella limitazione delle dimensioni della coda al quantum. In questo caso, il miniport IHV deve modificare in modo appropriato il quantum in modo da tenere conto del delta.

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

Esempio

Per definire una funzione di callback MINIPORT_WDI_TX_TARGET_DESC_INIT, è necessario innanzitutto 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 di callback MINIPORT_WDI_TX_TARGET_DESC_INIT denominata "MyTxTargetDescInit", usare il tipo di MINIPORT_WDI_TX_TARGET_DESC_INIT , come illustrato nell'esempio di codice seguente:

MINIPORT_WDI_TX_TARGET_DESC_INIT MyTxTargetDescInit;

Implementare quindi la funzione come segue:

_Use_decl_annotations_
VOID
 MyTxTargetDescInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL,
    NDIS_STATUS *pWifiStatus
    )
  {...}

Il tipo di funzione MINIPORT_WDI_TX_TARGET_DESC_INIT è 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_TARGET_DESC_INIT 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.