MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 콜백 함수(dot11wdi.h)

아티클
02/23/2024

중요

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

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

즉,

각 큐에는 TAL/target이 있는 미해결 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

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

[in] PeerId

피어 ID입니다.

[in] ExTidBitmask

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

반환 값

없음

설명

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

TargetPriorityQueueing이 TRUE인 경우 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 대한 자세한 내용은 함수 동작 주석 지정을 참조하세요.