MINIPORT_WDI_TX_ABORT función de devolución de llamada (dot11wdi.h)

Artículo
08/07/2023

Importante

Este tema forma parte del modelo de controlador WDI publicado en Windows 10. El modelo de controlador WDI está en modo de mantenimiento y solo recibirá correcciones de prioridad alta. WiFiCx es el modelo de controlador Wi-Fi lanzado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes.

La función de controlador MiniportWdiTxAbort anula los fotogramas TX pendientes para un puerto determinado o un par, lo que incluye iniciar la finalización de fotogramas propiedad del TAL/target. Esta solicitud se emite al TAL como parte del control de MiniportPause (anulación de TX para todo el adaptador), el restablecimiento de dot11 (anulación en todo el puerto) y después de NdisWdiPeerDeleteIndication si WDI está funcionando en modo de puesta en cola del mismo nivel.

Se trata de un controlador de miniporte WDI dentro de NDIS_MINIPORT_WDI_DATA_HANDLERS.

Nota Debe declarar la función mediante el tipo MINIPORT_WDI_TX_ABORT . Para obtener más información, consulte la sección Ejemplos siguientes.

Sintaxis

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
)
{...}

Parámetros

[in] MiniportTalTxRxContext

Identificador de dispositivo TAL devuelto por la miniporte IHV en MiniportWdiTalTxRxInitialize.

[in] PortId

Identificador de puerto.

[in] PeerId

Identificador del mismo nivel.

[out] pWifiStatus

Puntero a un estado del MiniportWdiTxAbort, que debe establecer el miniporte IHV. Consulte la sección Comentarios para obtener más información.

Valor devuelto

None

Observaciones

Se puede especificar un carácter comodín para que peerId detenga TX en un puerto.

Se puede especificar un carácter comodín para PortId y PeerId para detener TX en el adaptador.

Para completar la operación de detención, el TAL debe realizar los pasos siguientes.

Inicie la devolución de propiedad de los búferes de datos TX correspondientes a los parámetros de entrada al host. Estos fotogramas deben completarse indicando la finalización de transferencia de todos los fotogramas pasados a TxEngine en solicitudes de envío e indicando NdisWdiTxSendCompleteIndication para fotogramas TX pendientes que requieren finalización explícita de envío (si el marco TX no se ha completado con un código correcto).
Devuelve un estado correcto o devuelve un estado pendiente y emite NdisWdiTxAbortConfirm más adelante.

Ejemplos

Para definir una función MiniportWdiTxAbort, primero debe proporcionar una declaración de función que identifique el tipo de función que va a definir. Windows proporciona un conjunto de tipos de función para controladores. Declarar una función mediante los tipos de función ayuda a Code Analysis for Drivers, Static Driver Verifier (SDV) y otras herramientas de comprobación a encontrar errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir una función MiniportWdiTxAbort denominada "MyTxAbort", use el tipo MINIPORT_WDI_TX_ABORT como se muestra en este ejemplo de código:

MINIPORT_WDI_TX_ABORT MyTxAbort;

A continuación, implemente la función de la siguiente manera:

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

El tipo de función MINIPORT_WDI_TX_ABORT se define en el archivo de encabezado dot11wdi.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función MINIPORT_WDI_TX_ABORT en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, vea Declarar funciones mediante tipos de roles de función para controladores NDIS.

Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.