MINIPORT_WDI_TX_ABORT 콜백 함수(dot11wdi.h)

아티클
08/07/2023

중요

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

MiniportWdiTxAbort 처리기 함수는 TAL/대상이 소유한 프레임의 완료를 시작하는 것을 포함하여 지정된 포트 또는 피어에 대해 미해결 TX 프레임을 중단합니다. 이 요청은 MiniportPause (어댑터 전체 TX 중단), dot11 재설정(포트 전체 중단), WDI가 피어 큐 모드에서 작동하는 경우 NdisWdiPeerDeleteIndication 후에 처리의 일부로 TAL에 발급됩니다.

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

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

구문

MINIPORT_WDI_TX_ABORT MiniportWdiTxAbort;

void MiniportWdiTxAbort(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

매개 변수

[in] MiniportTalTxRxContext

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

[in] PortId

포트 ID입니다.

[in] PeerId

피어 ID입니다.

[out] pWifiStatus

IHV 미니포트에서 설정해야 하는 MiniportWdiTxAbort의 상태 대한 포인터입니다. 자세한 내용은 설명 섹션을 참조하세요.

반환 값

없음

설명

PeerId가 포트에서 TX를 중지하도록 와일드카드를 지정할 수 있습니다.

PortId 및 PeerId에 대한 와일드카드를 지정하여 어댑터에서 TX를 중지할 수 있습니다.

중지 작업을 완료하려면 TAL이 다음 단계를 수행해야 합니다.

호스트에 대한 입력 매개 변수에 해당하는 TX 데이터 버퍼의 소유권 반환을 시작합니다. 이러한 프레임은 전송 요청에서 TxEngine에 전달된 모든 프레임에 대한 전송 완료를 나타내고 명시적 송신 완료가 필요한 미해결 TX 프레임에 대한 NdisWdiTxSendCompleteIndication 을 표시하여 완료해야 합니다(TX 프레임이 성공 코드로 전송되지 않은 경우).
성공 상태 반환하거나 보류 중인 상태 반환하고 나중에 NdisWdiTxAbortConfirm을 발급합니다.

예제

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

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

MINIPORT_WDI_TX_ABORT MyTxAbort;

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

_Use_decl_annotations_
VOID
 MyTxAbort(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PORT_ID PortId,
    WDI_PEER_ID PeerId,
    NDIS_STATUS *pWifiStatus
    )
  {...}

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

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