Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Overliggende stuurprogramma's geven OID-setaanvragen van OID_RECEIVE_FILTER_CLEAR_FILTER om een ontvangstfilter op een netwerkadapter te wissen.
De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS structuur.
Opmerkingen
NDIS-ontvangstfilters worden gebruikt in de volgende NDIS-interfaces:
NDIS Packet Coalescing. Zie Ontvangen filters beherenvoor meer informatie over het gebruik van ontvangstfilters in deze interface.
I/O-virtualisatie met één hoofdmap (SR-IOV). Zie Een ontvangstfilter instellen op een virtuele poortvoor meer informatie over het gebruik van ontvangstfilters in deze interface.
VMQ (Virtual Machine Queue). Zie VmQ-filters instellen en wissenvoor meer informatie over het gebruik van ontvangstfilters in deze interface.
De OID-setaanvraag van OID_RECEIVE_FILTER_CLEAR_FILTER is verplicht voor minipoortstuurprogramma's die ondersteuning bieden voor de NDIS-pakketsamensmelten, SR-IOV of VMQ-interface.
Een overliggend stuurprogramma, zoals een NDIS-protocol of filterstuurprogramma, gebruikt de OID_RECEIVE_FILTER_CLEAR_FILTER setaanvraag om een eerder ingesteld filter te wissen. Alleen het stuurprogramma dat het ontvangstfilter instelt, kan dit wissen.
Het overliggende stuurprogramma wist een ontvangstfilter door de FilterId in te stellen lid van de NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS structuur op de id voor het filter. Het stuurprogramma heeft de filter-id verkregen van een eerdere OID-methodeaanvraag van OID_RECEIVE_FILTER_SET_FILTER.
Aanvullende instructies voor het samenvoegen van NDIS-pakketten
Het volgende punt is van toepassing op minipoort- en overliggende stuurprogramma's die NDIS-pakketsamenvoeging ondersteunen:
- Een overliggend stuurprogramma moet alle ontvangen filters wissen die zijn ingesteld op het minipoortstuurprogramma voordat het loskoppelt of loskoppelt van het stuurprogramma.
Aanvullende richtlijnen voor de SR-IOV-interface
De volgende punten zijn van toepassing op minipoort- en overliggende stuurprogramma's die ondersteuning bieden voor de SR-IOV-interface:
Een overliggend stuurprogramma moet alle filters wissen die zijn ingesteld op een SR-IOV VPort voordat de VPort wordt vrijgemaakt. Het overliggende stuurprogramma moet ook alle filters wissen die zijn ingesteld op de standaard-VPort voordat de binding met de netwerkadapter wordt gesloten.
Een minipoortstuurprogramma mag geen pakketten op een niet-standaard-VPort aangeven als het de OID-aanvraag van OID_RECEIVE_FILTER_CLEAR_FILTER heeft voltooid om het laatste filter op de VPort te wissen.
Opmerking Een minipoortstuurprogramma mag ook geen pakketten op een niet-standaard-VPort aangeven als deze een OID-aanvraag van OID_NIC_SWITCH_DELETE_VPORT heeft voltooid om de VPort vrij te maken.
Aanvullende richtlijnen voor de VMQ-interface
De volgende punten zijn van toepassing op minipoort- en te grote stuurprogramma's die ondersteuning bieden voor de VMQ-interface:
Een overliggend stuurprogramma moet alle filters wissen die zijn ingesteld op een VMQ-ontvangstwachtrij voordat de wachtrij wordt vrijgemaakt. Het overliggende stuurprogramma moet ook alle filters wissen die zijn ingesteld op de standaardwachtrijen of wachtrijen verwijderen voordat de binding met de netwerkadapter wordt gesloten.
Een minipoortstuurprogramma mag geen pakketten in een ontvangstwachtrij aangeven als deze de OID-aanvraag van OID_RECEIVE_FILTER_CLEAR_FILTER heeft voltooid om het laatste filter in de ontvangstwachtrij te wissen.
Opmerking Een minipoortstuurprogramma mag ook geen pakketten in een ontvangstwachtrij aangeven als er een OID-aanvraag van OID_RECEIVE_FILTER_FREE_QUEUE is voltooid om de ontvangstwachtrij vrij te maken.
Statuscodes retourneren
De MiniportOidRequest-functie van het minipoortstuurprogramma retourneert een van de volgende waarden voor deze aanvraag:
| Term | Beschrijving |
|---|---|
NDIS_STATUS_SUCCESS |
Het minipoortstuurprogramma heeft de aanvraag voltooid. |
NDIS_STATUS_PENDING |
Het minipoortstuurprogramma voltooit de aanvraag asynchroon. Nadat het minipoortstuurprogramma alle verwerking heeft voltooid, moet deze de aanvraag voltooien door de NdisMOidRequestComplete-functie aan te roepen en NDIS_STATUS_SUCCESS door te geven voor de parameter Status. |
NDIS_STATUS_NOT_ACCEPTED |
De minipoortadapter is onverwacht verwijderd. |
NDIS retourneert een van de volgende statuscodes voor deze aanvraag:
NDIS_STATUS_SUCCESS
Het opgegeven filter is gewist.
NDIS_STATUS_PENDING
De aanvraag is in behandeling. NDIS geeft de laatste statuscode en resultaten door aan de voltooiingshandler van de OID-aanvraag van de aanroeper nadat de aanvraag is voltooid.
NDIS_STATUS_FILE_NOT_FOUND
De filter-id is ongeldig.
NDIS_STATUS_INVALID_LENGTH
De informatiebuffer is te klein. NDIS stelt de DATA in. SET_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist.
Eisen
Versie |
Ondersteund in NDIS 6.20 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |