MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT 콜백 함수(dot11wdi.h)

중요

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

TxSuspectFrameListAbort 콜백 함수는 IHV 미니포트에 의해 구현되어 TxEngine에 TxMgr이 상당한 시간 동안 중단되거나 완료 보류 중인 것으로 의심되는 프레임을 식별했음을 알릴 수 있습니다.

구문

MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT MiniportWdiTxSuspectFrameListAbort;

void MiniportWdiTxSuspectFrameListAbort(
  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  UINT64 SuspectFrameContext,
  UINT16 NumSuspectFrames,
  PNET_BUFFER_LIST *SuspectFrameList
)
{...}

매개 변수

MiniportTalTxRxContext

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

SuspectFrameContext

의심되는 프레임에 대한 컨텍스트 정보입니다.

NumSuspectFrames

용의자 프레임의 수입니다.

SuspectFrameList

의심되는 프레임 목록입니다. 자세한 내용은 주의 섹션을 참조하세요.

반환 값

없음

설명

NDIS_MINIPORT_WDI_DATA_HANDLERS 구조체의 적절한 멤버를 설정하여 이 콜백 함수의 구현을 등록합니다.

선택적 처리기입니다. IHV 미니포트가 이 콜백의 동작을 구현하지 않는 경우 NDIS_MINIPORT_WDI_DATA_HANDLERS 함수 포인터를 설정하면 안 되며 WDI는 이 처리기를 호출하지 않습니다. 그러나 이 콜백의 동작이 구현되지 않은 경우 IHV 미니포트가 SuspectFrameList 를 사용하여 진단 목적으로 IHV 상태를 기록하는 경우에도 함수 포인터가 설정될 수 있습니다.

이 콜백 함수는 TxEngine에 TxMgr이 상당한 시간 동안 중단되거나 완료 보류 중인 것으로 의심되는 프레임을 식별했음을 알릴 수 있습니다. Next 포인터를 적용할 수 없는 NBL 포인터의 SuspectFrameList 배열은 프레임이 공중으로 전송되지 않더라도 TxMgr이 프롬프트 완료를 요청하는 프레임을 나타냅니다.

TxEngine은 처리기에 전달된 SuspectFrameContext를 사용하여 TxSuspectFrameListAbort 컨텍스트에서 TxQuerySuspectFrameStatus를 호출하여 SuspectFrameList 배열에서 NBL의 상태 검사 수 있습니다. TxMgr은 TxSuspectFrameAbort 기간 동안 SuspectFrameList의 NBL에 대해 TxTargetDescDeinit를 호출하지 않으며 프레임을 NDIS로 완료하지 않습니다.

TxEngine 또는 펌웨어가 용의자 프레임에 대한 지식이나 상태가 없는 경우 시스템 손상 및/또는 이중 완성을 일으킬 수 있으므로 해당 용의자 프레임에 대한 완료를 실행해서는 안 됩니다.

펌웨어가 중단되거나 손상이 감지되면 복구를 시도하려면 NDIS_STATUS_WDI_INDICATION_FIRMWARE_STALLED 알림이 표시되어야 합니다.

요구 사항

요구 사항	값
헤더	dot11wdi.h