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

Artículo
02/23/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 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.