WlanAssert 규칙(ndis)

아티클
06/14/2023

WlanAssert 규칙에는 WDIWIFI 드라이버 내에서 유효성이 검사된 검사 집합이 포함됩니다.

다음과 같은 위반이 발생할 수 있습니다.

TxPeerBacklogStub: 데이터 경로 초기화 후 데이터 경로라는 IHV WDI 미니포트 - 이 규칙은 Peer-Queuing 모드에만 적용됩니다. 미니포트가 중지되거나 다시 설정되면 WDI는 IHV 드라이버의 CloseAdapterHandler 함수를 호출합니다. 이 함수는 드라이버가 상태를 정리하고 그 이후의 데이터 콜백을 호출하지 않도록 요구합니다. 이러한 어설션은 드라이버가 닫기 후 TxTransferCompleteIndication, TxSendPauseIndication 또는 TxReleaseFrameIndication 과 같은 데이터 처리기를 호출하거나 Close 이후에도 미해결 Tx 프레임이 있는 경우 호출됩니다.
TxAbortStub: 데이터 경로 초기화 후 데이터 경로라는 IHV WDI 미니포트 - 이 규칙은 Peer-Queuing 모드에만 적용됩니다. 미니포트가 중지되거나 다시 설정되면 WDI는 IHV 드라이버의 CloseAdapterHandler 함수를 호출합니다. 이 함수는 드라이버가 상태를 정리하고 그 이후의 데이터 콜백을 호출하지 않도록 요구합니다. 이러한 어설션은 드라이버가 닫기 후 TxTransferCompleteIndication, TxSendPauseIndication 또는 TxReleaseFrameIndication 과 같은 데이터 처리기를 호출하거나 Close 이후에도 미해결 Tx 프레임이 있는 경우 호출됩니다.
NdisMDeregisterWdiMiniportDriver 및 NdisMRegisterWdiMiniportDriver에 대한 일치하지 않는 호출로 언로드되는 WDIWIFI 드라이버 - IHV 드라이버의 NdisMRegisterWdiMiniportDriver 호출이 실패한 경우 이 어설션이 호출되지만 IHV 드라이버는 여전히 NdisMDeregisterWdiMiniportDriver 처리기를 호출합니다.
IhvWdiVersion이 통과된 MiniportDataHandler 수정 버전에 비해 너무 낮 습니다. WDI는 OID_WDI_GET_ADAPTER_CAPABILITIES 호출하여 IHV 드라이버의 WDI 버전을 가져옵니다. 그런 다음 드라이버의 TalTxRxInitializeHandler 처리기를 호출하여 WdiCharacteristics를 가져옵니다. 여기서 드라이버는 필요한 경우 WDI 처리기 수정 버전을 업데이트할 수 있습니다. 드라이버의 WDI 버전이 WDI_VERSION_1_1_0 작거나 같지만 드라이버의 WdiCharacteristics, Revision이 NDIS_OBJECT_TYPE_MINIPORT_WDI_DATA_HANDLERS_REVISION_1보다 큰 버전으로 설정된 경우 이 어설션이 적중됩니다.
MiniportDataHandler 수정 버전이 IhvWdiVersion에 비해 너무 낮 음 - WDI는 OID_WDI_GET_ADAPTER_CAPABILITIES 호출하여 IHV 드라이버의 WDI 버전을 가져옵니다. 그런 다음 드라이버의 TalTxRxInitializeHandler 처리기를 호출하여 WdiCharacteristics를 가져옵니다. 여기서 드라이버가 필요한 경우 WDI 처리기 수정 버전을 업데이트할 수 있습니다. 드라이버의 WDI 버전이 WDI_VERSION_1_1_0보다 크지만 드라이버의 WdiCharacteristics, Revision이 NDIS_OBJECT_TYPE_MINIPORT_WDI_DATA_HANDLERS_REVISION_2 미만의 버전으로 설정된 경우 이 어설션이 적중됩니다.