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

Artigo
02/26/2024

Importante

Este tópico faz parte do modelo de driver WDI lançado em 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 em 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 um 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 em pausa, nenhuma das NET_BUFFER_LISTs será liberada.

Esse é um retorno de chamada dentro 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 de 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. O 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.

Retornar valor

Nenhum

Comentários

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

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

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