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

Artículo
02/26/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 Wi-Fi lanzado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes.

La función de controlador MiniportWdiTxDataSend especifica una cola de puertos o RA-TID desde la que se va a transmitir. Se emite en el contexto del subproceso TX desde el sistema operativo, la indicación de reanudación o un elemento de trabajo.

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

Sintaxis

MINIPORT_WDI_TX_DATA_SEND MiniportWdiTxDataSend;

void MiniportWdiTxDataSend(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] WDI_PORT_ID PortId,
  [in] WDI_PEER_ID PeerId,
  [in] WDI_EXTENDED_TID ExTid,
  [in] UINT16 NumQueueFrames,
  [in] UINT32 NumActiveFrames,
  [in] BOOLEAN bRobustnessFlag
)
{...}

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.

[in] ExTid

TID extendido.

[in] NumQueueFrames

Longitud de la cola, en fotogramas.

[in] NumActiveFrames

Número total de fotogramas en colas de acción (programables).

[in] bRobustnessFlag

Marca de solidez. Si la marca de solidez se establece en TRUE, la NIC garantiza una entrega confiable dentro de un pequeño número de reintentos al reducir agresivamente la velocidad de datos TX utilizada para el fotograma mediante CTS y/u otros mecanismos.

Valor devuelto

None

Observaciones

En el modo de puesta en cola de puertos, el WDI_PEER_ID y el WDI_EXTENDED_TID se establecen en caracteres comodín. En el contexto de la solicitud de envío, TxEngine emite NdisWdiTxDequeueIndication para tomar posesión de una serie de fotogramas de la cola DE RA-TID de FIFO y transferirlos al destino. Si no puede quitar de la cola ningún fotograma, TxEngine emite NdisWdiTxSendPauseIndication en el mismo contexto en lugar de NdisWdiTxDequeueIndication.

TxEngine debe emitir una transferencia completa y enviar indicaciones completas para devolver la propiedad de los fotogramas que desqueues a TxMgr. Si la transferencia completada contiene un código de error, TxEngine no debe emitir una finalización de envío.

Ejemplos

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

MINIPORT_WDI_TX_DATA_SEND MyTxDataSend;

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

_Use_decl_annotations_
VOID
 MyTxDataSend(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PORT_ID PortId,
    WDI_PEER_ID PeerId,
    WDI_EXTENDED_TID ExTid,
    UINT16 NumQueueFrames,
    UINT32 NumActiveFrames,
    BOOLEAN bRobustnessFlag
    )
  {...}

El tipo de función MINIPORT_WDI_TX_DATA_SEND 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_DATA_SEND 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.