MINIPORT_WDI_TX_TARGET_DESC_DEINIT 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 de 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_DEINIT informa al TxEngine de que los descriptores TX de destino asociados a la NET_BUFFER_LIST (NBL) de la cadena NBL ya no son necesarios y se pueden liberar.

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

Sintaxis

MINIPORT_WDI_TX_TARGET_DESC_DEINIT MiniportWdiTxTargetDescDeinit;

void MiniportWdiTxTargetDescDeinit(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] PNET_BUFFER_LIST pNBL
)
{...}

Parámetros

[in] MiniportTalTxRxContext

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

[in] pNBL

Puntero a una cadena de NET_BUFFER_LIST .

Valor devuelto

None

Observaciones

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

Ejemplos

Para definir un MINIPORT_WDI_TX_TARGET_DESC_DEINIT función de devolución de llamada, 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_DEINIT denominada "MyTxTargetDescDeInit", use el tipo de MINIPORT_WDI_TX_TARGET_DESC_DEINIT como se muestra en este ejemplo de código:

MINIPORT_WDI_TX_TARGET_DESC_DEINIT MyTxTargetDescDeInit;

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

_Use_decl_annotations_
VOID
 MyTxTargetDescDeInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL
    )
  {...}

El tipo de función MINIPORT_WDI_TX_TARGET_DESC_DEINIT 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_DEINIT 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.