MINIPORT_WDI_TX_TARGET_DESC_INIT 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 devolución de llamada MINIPORT_WDI_TX_TARGET_DESC_INIT asocia un descriptor TX de destino opaco con el NET_BUFFER_LIST (campo MiniportReserved[1] ) 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 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

None

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 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 de NDIS adecuadas. El inicio del desplazamiento de paquetes 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 fotograma 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 IHV debe ajustar adecuadamente el cuántico 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 está definiendo. 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 de devolución de llamada MINIPORT_WDI_TX_TARGET_DESC_INIT denominada "MyTxTargetDescInit", use el tipo de MINIPORT_WDI_TX_TARGET_DESC_INIT 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 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.