MINIPORT_WDI_TX_TARGET_DESC_INIT 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 devolución de llamada MINIPORT_WDI_TX_TARGET_DESC_INIT asocia un descriptor TX de destino opaco con el NET_BUFFER_LIST (MiniportReserved[1] campo) y (si procede) rellena el campo de costo TX (en unidades de crédito) en el búfer de WDI_FRAME_METADATA del NET_BUFFER_LIST (MiniportReserved[0]).

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

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

Sintaxis

MINIPORT_WDI_TX_TARGET_DESC_INIT MiniportWdiTxTargetDescInit;

void MiniportWdiTxTargetDescInit(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  PNET_BUFFER_LIST pNBL,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Parámetros

[in] MiniportTalTxRxContext

Identificador de dispositivo TAL devuelto por la miniporte IHV en la función de devolución de llamada MINIPORT_WDI_TAL_TXRX_INITIALIZE.

[in] pNBL

Puntero a una sola NET_BUFFER_LIST.

[out] pWifiStatus

Puntero al estado establecido por el IHV para indicar el resultado de la función de devolución de llamada MINIPORT_WDI_TX_TARGET_DESC_INIT.

Valor devuelto

Ninguno

Observaciones

Solo se debe usar un estado de NDIS_STATUS_RESOURCES cuando se agoten los descriptores Tx. El mejor comportamiento se produce si el miniporte de IHV no usa NDIS_STATUS_RESOURCES. Cualquier estado distinto de NDIS_STATUS_SUCCESS y NDIS_STATUS_RESOURCES debe usarse para cualquier otro error que indique que el miniporte o firmware de IHV no puede procesar el NET_BUFFER_LIST.

El minipuerto de IHV puede utilizar el reposición en el NET_BUFFER mediante las funciones de retirada y avance NDIS adecuadas. El inicio del desplazamiento del paquete debe restaurarse antes o en la función de devolución de llamada MINIPORT_WDI_TX_TARGET_DESC_DEINIT. TxMgr determina la longitud del fotograma durante el tiempo de puesta en cola, por lo que cualquier cambio en la longitud del marco de la función de devolución de llamada MINIPORT_WDI_TX_TARGET_DESC_INIT se incluye al limitar el tamaño de la cola al cuántico. En este caso, el miniporte de IHV debe ajustar adecuadamente el quantum para tener en cuenta la diferencia.

Importante No se permite que el miniporte IHV realice ninguna indicación en el contexto de esta llamada. TxMgr serializa las llamadas a TxTargetDescInitHandler.

Ejemplos

Para definir una función de devolución de llamada MINIPORT_WDI_TX_TARGET_DESC_INIT, 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 de devolución de llamada MINIPORT_WDI_TX_TARGET_DESC_INIT denominada "MyTxTargetDescInit", use el tipo MINIPORT_WDI_TX_TARGET_DESC_INIT tal como se muestra en este ejemplo de código:

MINIPORT_WDI_TX_TARGET_DESC_INIT MyTxTargetDescInit;

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

_Use_decl_annotations_
VOID
 MyTxTargetDescInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL,
    NDIS_STATUS *pWifiStatus
    )
  {...}

El tipo de función MINIPORT_WDI_TX_TARGET_DESC_INIT 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_TARGET_DESC_INIT 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