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

Artículo
02/23/2024

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 de Wi-Fi publicado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes.

La función de controlador MiniportWdiTxTalQueueInOrder notifica al destino TAL que una o varias colas de RA/TID en pausa (con WDI_TX_PAUSE_REASON_PS) están listas para transmitirse.

Esto significa:

Cada una de las colas no tiene fotogramas TX pendientes con TAL/target.
Todos los fotogramas que se completaron con tx con WDI_TxFrameStatus_SendPostponed se insertaron en la cola RA-TID en el orden correcto.

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_TAL_QUEUE_IN_ORDER . Para obtener más información, consulte la sección Ejemplos siguientes.

Sintaxis

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MiniportWdiTxTalQueueInOrder;

void MiniportWdiTxTalQueueInOrder(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] WDI_PEER_ID PeerId,
  [in] UINT32 ExTidBitmask
)
{...}

Parámetros

[in] MiniportTalTxRxContext

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

[in] PeerId

Identificador del mismo nivel.

[in] ExTidBitmask

Máscara de bits TID extendida.

Valor devuelto

None

Observaciones

El TAL/destino espera esta notificación antes de emitir una indicación de reinicio tx a una cola en pausa con WDI_TX_PAUSE_REASON_PS.

NotaWDI_TxFrameStatus_SendPostponed no se permite cuando TargetPriorityQueueing es TRUE, por lo que esta solicitud nunca se realiza en ese modo.

Ejemplos

Para definir una función MiniportWdiTxTalQueueInOrder, 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 MiniportWdiTxTalQueueInOrder denominada "MyTxTalQueueInOrder", use el tipo de MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER como se muestra en este ejemplo de código:

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MyTxTalQueueInOrder;

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

_Use_decl_annotations_
VOID
 MyTxTalQueueInOrder(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PEER_ID PeerId,
    UINT32 ExTidBitmask
    )
  {...}

El tipo de función MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 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_TAL_QUEUE_IN_ORDER en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte 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, consulte Anotación del comportamiento de la función.