Règle WlanAssert (ndis)

Article
02/07/2024

La règle WlanAssert inclut un ensemble de vérifications validées à l’intérieur du pilote WDIWIFI.

Les violations suivantes sont possibles :

TxPeerBacklogStub : miniport WDI IHV appelé datapath après la désinitialisation du chemin de données : cette règle s’applique uniquement au mode Peer-Queuing. Lorsque le Miniport a été arrêté ou réinitialisé, WDI appelle la fonction CloseAdapterHandler du pilote IHV, ce qui oblige le pilote à nettoyer son état et à ne pas appeler les rappels de données après cela. Ces assertions sont appelées si le pilote appelle l’un des gestionnaires de données tels que TxTransferCompleteIndication, TxSendPauseIndication ou TxReleaseFrameIndication après la fermeture, ou s’il reste des images Tx en suspens après la fermeture.
TxAbortStub : miniport WDI IHV appelé datapath après la désinitialisation du chemin de données : cette règle s’applique uniquement au mode Peer-Queuing. Lorsque le Miniport a été arrêté ou réinitialisé, WDI appelle la fonction CloseAdapterHandler du pilote IHV, ce qui oblige le pilote à nettoyer son état et à ne pas appeler les rappels de données après cela. Ces assertions sont appelées si le pilote appelle l’un des gestionnaires de données tels que TxTransferCompleteIndication, TxSendPauseIndication ou TxReleaseFrameIndication après la fermeture, ou s’il reste des images Tx en suspens après la fermeture.
Le pilote WDIWIFI est déchargé avec des appels incompatibles vers NdisMDeregisterWdiMiniportDriver et NdisMRegisterWdiMiniportDriver : cette assertion est appelée si l’appel du pilote IHV à NdisMRegisterWdiMiniportDriver a échoué, mais que le pilote IHV appelle toujours le gestionnaire NdisMDeregisterWdiMiniportDriver.
L’IhvWdiVersion est trop faible pour la révision De MiniportDataHandler réussie : WDI obtient la version WDI du pilote IHV en appelant OID_WDI_GET_ADAPTER_CAPABILITIES, puis appelle le gestionnaire TalTxRxInitializeHandler du pilote pour obtenir WdiCharacteristics, où le pilote peut mettre à jour la révision du gestionnaire WDI si nécessaire. Cette assertion est atteinte si la version WDI du pilote est inférieure ou égale à WDI_VERSION_1_1_0, mais que la version WdiCharacteristics, Revision du pilote est définie sur une version supérieure à NDIS_OBJECT_TYPE_MINIPORT_WDI_DATA_HANDLERS_REVISION_1.
La révision MiniportDataHandler est trop faible pour IhvWdiVersion : WDI obtient la version WDI du pilote IHV en appelant OID_WDI_GET_ADAPTER_CAPABILITIES, puis appelle le gestionnaire TalTxRxInitializeHandler du pilote pour obtenir WdiCharacteristics, où le pilote peut mettre à jour la révision du gestionnaire WDI si nécessaire. Cette assertion est atteinte si la version WDI du pilote est supérieure à WDI_VERSION_1_1_0, mais que la version WdiCharacteristics, Revision du pilote est définie sur une version inférieure à NDIS_OBJECT_TYPE_MINIPORT_WDI_DATA_HANDLERS_REVISION_2.