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

Artículo
02/06/2025

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 publicado 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 o punto determinado, lo que incluye iniciar la finalización de fotogramas propiedad del TAL/destino. Esta solicitud se emite al TAL como parte del control de MiniportPause (anulación de TX para todo el adaptador), restablecimiento de dot11 (anulación en todo el puerto) y después de NdisWdiPeerDeleteIndication si WDI funciona 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 de MiniportWdiTxAbort, que debe establecerse mediante el miniporte IHV. Consulte la sección Comentarios para obtener más información.

Valor devuelto

Ninguno

Observaciones

Se puede especificar un carácter comodín para el peerId de para detener 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 para 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 posterior.

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 análisis de código para controladores, comprobador de controladores estáticos (SDV) y otras herramientas de comprobación encuentran 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 Declaración de funciones mediante el uso de tipos de roles de función para controladores NDIS.

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

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10
servidor mínimo admitido	Windows Server 2016
de la plataforma de destino de	Windows
encabezado de	dot11wdi.h