NDIS_WDI_TX_DEQUEUE_IND 콜백 함수(dot11wdi.h)

아티클
02/26/2024

중요

이 항목은 Windows 10 릴리스된 WDI 드라이버 모델의 일부입니다. WDI 드라이버 모델은 유지 관리 모드이며 높은 우선 순위 수정만 받습니다. WiFiCx는 Windows 11 릴리스된 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다.

NdisWdiTxDequeueIndication 콜백 함수는 IHV 미니포트에 의해 MiniportWdiTxDataSend 또는 MiniportWdiTxTalSend 의 컨텍스트에서 호출되어 WDI에서 IHV 미니포트로 프레임을 큐에서 제거합니다.

이는 NDIS_WDI_DATA_API 내부의 콜백입니다.

구문

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
)
{...}

매개 변수

[in] NdisMiniportDataPathHandle

MiniportWdiTalTxRxInitialize의 IHV 미니포트에 전달된 NdisMiniportDataPathHandle입니다.

[in] Quantum

양자입니다. 자세한 내용은 WDI TX 경로의 호스트 - 대상 TX 전송 예약 섹션을 참조하세요.

[in] MaxNumFrames

최대 프레임 수입니다.

[in] Credit

크레딧 값입니다. 자세한 내용은 대상-크레딧 체계 및 WDI TX 경로의 일시 중지/다시 시작 메커니즘 섹션을 참조하세요.

[out] ppNBL

WDI에서 큐에서 해제된 NET_BUFFER_LIST 체인에 대한 포인터에 대한 포인터입니다.

반환 값

없음

설명

매개 변수의 하위 집합은 디바이스에 적용되지 않을 수 있습니다. instance 경우 최대 프레임 수는 저장소 및 전달 디바이스(메시지 기반 버스 인터페이스)에 적용되지 않을 수 있습니다.

이러한 상황에서는 TxMgr에서 다음 매개 변수를 무시합니다.

WDI_TX_QUANTUM_INVALID ( 0xFFFFFFFF )로 설정된 양자
WDI_TX_MAX_FRAME_COUNT_INVALID(0xFF)로 설정된 경우 MaxNumFrames
WDI_TX_CREDIT_INVALID ( 0xFFFF )로 설정된 경우 크레딧

TAL은 공정성을 보장하고 압도적인 TIL/대상 리소스를 방지하기 위해 가능한 한 정확한 매개 변수를 제공해야 합니다.

TAL에 최대 비용 프레임을 큐에서 제거하기에 충분한 크레딧이 없는 경우 NdisWdiTxDequeueIndication 대신 NdisWdiTxSendPauseIndication을 발급해야 합니다.

TxMgr은 프레임 수, 프레임 비용 또는 양자 수를 초과하는 NET_BUFFER_LIST 목록을 반환할 수 있습니다. 이는 지연된 상태 동일한 시퀀스 번호로 전송된 후 프레임이 다시 큐에 저장/재생되는 경우에만 발생합니다. 이는 원래 단일 A-MSDU의 일부로 전송되었음을 나타냅니다.