MINIPORT_WDI_TX_ABORT funzione di callback (dot11wdi.h)

La funzione del gestore MiniportWdiTxAbort interrompe i frame TX in sospeso per una determinata porta o peer, che include l'avvio del completamento dei fotogrammi di proprietà del TAL/target. Questa richiesta viene inviata al TAL come parte della gestione di MiniportPause (interruzione TX a livello di adattatore), dot11 reset (abort a livello di porta) e dopo NdisWdiPeerDeleteIndication se WDI funziona in modalità di accodamento peer.

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

Sintassi

MINIPORT_WDI_TX_ABORT MiniportWdiTxAbort;

void MiniportWdiTxAbort(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Parametri

[in] MiniportTalTxRxContext

Handle del dispositivo TAL restituito dal miniport IHV in MiniportWdiTalTxRxInitialize.

[in] PortId

ID porta.

[in] PeerId

ID peer.

[out] pWifiStatus

Puntatore a uno stato del miniportWdiTxAbort, che deve essere impostato dal miniport IHV. Per altre informazioni, vedere la sezione Osservazioni .

Valore restituito

nessuno

Osservazioni

È possibile specificare un carattere jolly per peerid per arrestare TX su una porta.

È possibile specificare un carattere jolly per PortId e PeerId per arrestare TX nell'adapter.

Per completare l'operazione di arresto, il tal deve eseguire i passaggi seguenti.

1. Avviare la restituzione della proprietà dei buffer di dati TX corrispondenti ai parametri di input all'host. Questi fotogrammi devono essere completati indicando il completamento del trasferimento per tutti i fotogrammi passati al TxEngine nelle richieste di invio e indicando NdisWdiTxSendCompleteIndication per i frame TX in attesa che richiedono il completamento esplicito dell'invio (se il frame TX non è stato trasferito completato con un codice di operazione riuscita).
2. Restituisce uno stato di esito positivo o restituisce uno stato in sospeso e rilasciare NdisWdiTxAbortConfirm in un secondo momento.

Esempio

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

MINIPORT_WDI_TX_ABORT MyTxAbort;

Implementare quindi la funzione come segue:

_Use_decl_annotations_
VOID
 MyTxAbort(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PORT_ID PortId,
    WDI_PEER_ID PeerId,
    NDIS_STATUS *pWifiStatus
    )
  {...}

Il tipo di funzione MINIPORT_WDI_TX_ABORT è 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_ABORT 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.

Requisiti

Vedi anche

MiniportPause

NDIS_MINIPORT_WDI_DATA_HANDLERS

NdisWdiPeerDeleteIndication

NdisWdiTxAbortConfirm

NdisWdiTxSendCompleteIndication

TAL_TXRX_HANDLE

Percorso TX WDI

WDI_PEER_ID

WDI_PORT_ID