NDIS_WDI_TX_RELEASE_FRAMES_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 NdisWdiTxReleaseFrameIndication libera hasta un número especificado o un costo agregado de fotogramas en cola en una combinación determinada de TID del mismo nivel cuando la transmisión está en pausa. Si las colas especificadas no están en pausa, no se libera ninguno de los NET_BUFFER_LISTs.

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

Sintaxis

NDIS_WDI_TX_RELEASE_FRAMES_IND NdisWdiTxReleaseFramesInd;

void NdisWdiTxReleaseFramesInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [in]  UINT32 ExTidBitmask,
  [in]  UINT8 MaxNumFrames,
  [in]  UINT16 Credit,
  [out] PNET_BUFFER_LIST *ppNBL
)
{...}

Parámetros

[in] NdisMiniportDataPathHandle

NdisMiniportDataPathHandle pasó a la miniporte IHV en MiniportWdiTalTxRxInitialize.

[in] PortId

Identificador de puerto. Debe ser un valor que no sea comodín.

[in] PeerId

Identificador del mismo nivel. Debe ser un valor que no sea comodín.

[in] ExTidBitmask

Máscara de bits TID extendida.

[in] MaxNumFrames

Número máximo de fotogramas. MaxNumFrames se omite si se establece en WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF).

[in] Credit

Crédito. El crédito se omite si se establece en WDI_TX_CREDIT_INVALID (0xFFFF).

[out] ppNBL

Puntero a un puntero a una cadena de NET_BUFFER_LIST de fotogramas liberados.

Valor devuelto

None

Observaciones

Si una de las colas especificadas está en pausa con WDI_TX_PAUSE_REASON_PS, tal/destino no emite esta indicación hasta que haya recibido una indicación MiniportWdiTxTalQueueInOrder para esa cola.

Esta indicación solo se permite cuando TargetPriorityQueueing es false.

TxMgr puede devolver una lista de NET_BUFFER_LIST que superen el límite del número de fotogramas o el costo de fotogramas. Esto solo sucede si los fotogramas se vuelven a poner en cola después de enviarse 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.