NDIS_WDI_TX_RELEASE_FRAMES_IND função de retorno de chamada (dot11wdi.h)

Artigo
02/06/2025

Importante

Este tópico faz parte do modelo de driver WDI lançado no Windows 10. O modelo de driver WDI está no modo de manutenção e receberá apenas correções de alta prioridade. WiFiCx é o modelo de driver Wi-Fi lançado no Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes.

A função de retorno de chamada NdisWdiTxReleaseFrameIndication libera até um número especificado ou custo agregado de quadros enfileirados em uma determinada combinação de TID par quando a transmissão é pausada. Se as filas especificadas não estiverem pausadas, nenhuma das NET_BUFFER_LISTs será liberada.

Esse é um retorno de chamada dentro de NDIS_WDI_DATA_API.

Sintaxe

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

O NdisMiniportDataPathHandle passou para o miniporto IHV em MiniportWdiTalTxRxInitialize.

[in] PortId

A ID da porta. Deve ser um valor não curinga.

[in] PeerId

A ID do par. Deve ser um valor não curinga.

[in] ExTidBitmask

A máscara de bits TID estendida.

[in] MaxNumFrames

Contagem máxima de quadros. MaxNumFrames será ignorado se estiver definido como WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF).

[in] Credit

Crédito. de Crédito será ignorado se estiver definido como WDI_TX_CREDIT_INVALID (0xFFFF).

[out] ppNBL

Ponteiro para um ponteiro para uma cadeia NET_BUFFER_LIST de quadros liberados.

Valor de retorno

Nenhum

Observações

se uma das filas especificadas estiver pausada com WDI_TX_PAUSE_REASON_PS, o TAL/Target não emitirá essa indicação até receber uma indicação MiniportWdiTxTalQueueInOrder indicação para essa fila.

Essa indicação só é permitida quando TargetPriorityQueueing é falso.

O TxMgr pode retornar uma lista de NET_BUFFER_LIST que excedem o limite do número de quadros ou custo do quadro. Isso só ocorrerá se os quadros estiverem sendo requeuados após serem enviados com o status de Adiado e com o número de sequência idêntico, o que indica que eles foram transmitidos originalmente como parte de um único A-MSDU.