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

Artigo
02/23/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 NdisWdiTxDequeueIndication é chamada no contexto de um MiniportWdiTxDataSend ou MiniportWdiTxTalSend pelo miniporto IHV para remover quadros do WDI para o miniporto IHV.

Esse é um retorno de chamada dentro de NDIS_WDI_DATA_API.

Sintaxe

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

O NdisMiniportDataPathHandle passou para o miniporto IHV em MiniportWdiTalTxRxInitialize.

[in] Quantum

O quântico. Para obter mais informações, consulte a seção Host – agendamento de transferência TX de destino no caminho TX do WDI.

[in] MaxNumFrames

Contagem máxima de quadros.

[in] Credit

Valor de crédito. Para obter mais informações, consulte A seção esquema de crédito de destino e o mecanismo de pausa/retomada no caminho TX do WDI.

[out] ppNBL

Ponteiro para um ponteiro para uma cadeia de NET_BUFFER_LIST desativada pelo WDI.

Retornar valor

Nenhum

Comentários

Um subconjunto dos parâmetros pode não ser aplicável a um dispositivo. Por exemplo, a contagem máxima de quadros pode não se aplicar a um dispositivo de armazenamento e encaminhamento (interface de barramento baseada em mensagem).

Os parâmetros a seguir são ignorados pelo TxMgr nessas circunstâncias.

Quantum se definido como WDI_TX_QUANTUM_INVALID (0xFFFFFFFF)
MaxNumFrames se definido como WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF)
Crédito se definido como WDI_TX_CREDIT_INVALID (0xFFFF)

O TAL deve fornecer parâmetros precisos sempre que possível para garantir a imparcialidade e evitar sobrecarregar os recursos til/target.

Se o TAL não tiver crédito suficiente para remover um quadro de custo máximo, ele deverá emitir um NdisWdiTxSendPauseIndication em vez de um NdisWdiTxDequeueIndication.

O TxMgr pode retornar uma lista de NET_BUFFER_LIST que excedem o limite do número de quadros, custo de quadro ou quantum. Isso só acontecerá se os quadros estiverem sendo requeuados/reproduzidos 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.