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

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 NdisWdiTxDequeueIndication se llama en el contexto de un MiniportWdiTxDataSend o MiniportWdiTxTalSend por la miniporte IHV para desqueue fotogramas de WDI a la miniporte IHV.

Se trata de una devolución de llamada dentro de NDIS_WDI_DATA_API.

Sintaxis

NDIS_WDI_TX_DEQUEUE_IND NdisWdiTxDequeueInd;

void NdisWdiTxDequeueInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  UINT32 Quantum,
  [in]  UINT8 MaxNumFrames,
  [in]  UINT16 Credit,
  [out] PNET_BUFFER_LIST *ppNBL
)
{...}

Parámetros

[in] NdisMiniportDataPathHandle

NdisMiniportDataPathHandle pasó a la miniporte IHV en MiniportWdiTalTxRxInitialize.

[in] Quantum

Cuanto. Para obtener más información, consulte la sección Programación de transferencia de TX de host - destino en ruta de acceso de WDI TX.

[in] MaxNumFrames

Número máximo de fotogramas.

[in] Credit

Valor de crédito. Para obtener más información, consulte la sección Esquema de crédito de destino y el mecanismo de pausa/reanudación en laruta de acceso de WDI TX.

[out] ppNBL

Puntero a un puntero a una cadena de NET_BUFFER_LIST puesta en cola por WDI.

Valor devuelto

None

Observaciones

Es posible que un subconjunto de los parámetros no sea aplicable a un dispositivo. Por ejemplo, es posible que el número máximo de fotogramas no se aplique a un dispositivo de almacenamiento y reenvío (interfaz de bus basada en mensajes).

TxMgr omite los parámetros siguientes en estas circunstancias.

  • Quantum si se establece en WDI_TX_QUANTUM_INVALID (0xFFFFFFFF)
  • MaxNumFrames si se establece en WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF)
  • Crédito si se establece en WDI_TX_CREDIT_INVALID (0xFFFF)
El TAL debe proporcionar parámetros precisos siempre que sea posible para garantizar la equidad y evitar sobrecargar los recursos TIL/destino.

Si el TAL no tiene suficiente crédito para poner en cola un marco de costo máximo, debe emitir un NdisWdiTxSendPauseIndication en lugar de NdisWdiTxDequeueIndication.

TxMgr puede devolver una lista de NET_BUFFER_LIST que superen el límite del número de fotogramas, el costo de fotogramas o el cuántico. Esto solo sucede si los fotogramas se vuelven a poner en cola o reproducir después de enviarse completados con el estado Pospuesto y con un número de secuencia idéntico, lo que indica que se transmitieron originalmente como parte de una sola A-MSDU.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado dot11wdi.h

Consulte también

NDIS_WDI_DATA_API

NET_BUFFER_LIST

NdisWdiTxDequeueIndication

NdisWdiTxSendPauseIndication

Ruta de acceso de WDI TX