NDIS_WDI_TX_DEQUEUE_IND 콜백 함수(dot11wdi.h)

아티클
02/06/2025

중요하다

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

NdisWdiTxDequeueIndication 콜백 함수는 MiniportWdiTxDataSend 컨텍스트에서 호출되거나 IHV 미니포트에 의해 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 체인에 대한 포인터에 대한 포인터입니다.

반환 값

없음

발언

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

이러한 경우 TxMgr에서 다음 매개 변수를 무시합니다.

WDI_TX_QUANTUM_INVALID(0xFFFFFFFF)로 설정된 경우 Quantum
WDI_TX_MAX_FRAME_COUNT_INVALID(0xFF)로 설정된 경우 maxNumFrames
WDI_TX_CREDIT_INVALID(0xFFFF)로 설정된 경우 크레딧

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

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

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