MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 콜백 함수(dot11wdi.h)

아티클
02/06/2025

중요하다

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

MiniportWdiTxTalQueueInOrder 처리기 함수는 하나 이상의 일시 중지된 RA/TID 큐(WDI_TX_PAUSE_REASON_PS포함)가 전송할 준비가 되었다는 것을 TAL 대상에 알깁니다.

즉, 다음을 의미합니다.

각 큐에는 TAL/대상이 있는 미해결 TX 프레임이 없습니다.
WDI_TxFrameStatus_SendPostponed TX가 완료된 모든 프레임이 올바른 순서로 RA-TID 큐에 삽입되었습니다.

NDIS_MINIPORT_WDI_DATA_HANDLERS내의 WDI 미니포트 처리기입니다.

참고MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 형식을 사용하여 함수를 선언해야 합니다. 자세한 내용은 다음 예제 섹션을 참조하세요.

통사론

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MiniportWdiTxTalQueueInOrder;

void MiniportWdiTxTalQueueInOrder(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] WDI_PEER_ID PeerId,
  [in] UINT32 ExTidBitmask
)
{...}

매개 변수

[in] MiniportTalTxRxContext

MiniportWdiTalTxRxInitializeIHV 미니포트에서 반환된 TAL 디바이스 핸들입니다.

[in] PeerId

피어 ID입니다.

[in] ExTidBitmask

확장 TID 비트 마스크입니다.

반환 값

없음

발언

TAL/대상은 WDI_TX_PAUSE_REASON_PS있는 일시 중지된 큐에 TX 다시 시작 표시를 실행하기 전에 이 알림을 기다립니다.

TargetPriorityQueueing 때는WDI_TxFrameStatus_SendPostponed 허용되지 않으므로 해당 모드에서는 이 요청이 수행되지 않습니다.

예제

MiniportWdiTxTalQueueInOrder 함수를 정의하려면 먼저 정의하려는 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버 , SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 코드 분석을데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.

예를 들어 "MyTxTalQueueInOrder"라는 MiniportWdiTxTalQueueInOrder 함수를 정의하려면 이 코드 예제와 같이 MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 형식을 사용합니다.

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MyTxTalQueueInOrder;

그런 다음 다음과 같이 함수를 구현합니다.

_Use_decl_annotations_
VOID
 MyTxTalQueueInOrder(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PEER_ID PeerId,
    UINT32 ExTidBitmask
    )
  {...}

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 함수 형식은 dot11wdi.h 헤더 파일에 정의됩니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 함수 형식에 적용되는 주석이 사용되는지 확인합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버함수 역할 형식을 사용하여 함수 선언을 참조하세요.

Use_decl_annotations대한 자세한 내용은 함수 동작 주석참조하세요.