OID_RECEIVE_FILTER_MOVE_FILTER
Een overliggend stuurprogramma geeft een OID-setaanvraag (object-id) van OID_RECEIVE_FILTER_MOVE_FILTER om een eerder geconfigureerd ontvangstfilter te verplaatsen. Ontvangstfilters worden verplaatst van één virtuele poort (VPort) naar een andere VPort.
Bij het overliggen van stuurprogramma's wordt deze OID-setaanvraag verzonden naar het minipoortstuurprogramma voor de PCIe Physical Function (PF) van de netwerkadapter. Deze OID-setaanvraag is vereist voor PF-minipoortstuurprogramma's die ondersteuning bieden voor de I/O-interface met één hoofdmap (SR-IOV).
De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS structuur.
Opmerkingen
NDIS valideert de leden van de NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS-structuur voordat de OID-setaanvraag wordt doorgestuurd naar het PF-minipoortstuurprogramma.
Het PF-minipoortstuurprogramma moet deze aanvraag voor de OID-set atomisch afhandelen. Het stuurprogramma moet de netwerkadapter kunnen configureren om tegelijkertijd het filter uit een ontvangstwachtrij en VPort te verwijderen en in te stellen op een andere ontvangstwachtrij en VPort.
Zie Een ontvangstfilter verplaatsen naar een virtuele poortvoor meer informatie.
Statuscodes retourneren
Het PF-minipoortstuurprogramma retourneert een van de volgende statuscodes voor de OID-setaanvraag van OID_RECEIVE_FILTER_MOVE_FILTER.
| Statuscode | Beschrijving |
|---|---|
NDIS_STATUS_SUCCESS |
De OID-aanvraag is voltooid. |
NDIS_STATUS_NOT_SUPPORTED |
Het PF-minipoortstuurprogramma biedt geen ondersteuning voor de I/O-interface met één hoofdmap (SR-IOV) of is niet ingeschakeld voor het gebruik van de interface. |
NDIS_STATUS_INVALID_PARAMETER |
Een of meer leden van de NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS structuur hebben ongeldige waarden. |
NDIS_STATUS_INVALID_LENGTH |
De lengte van de informatiebuffer is kleiner dan grootte (NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS). Het PF-minipoortstuurprogramma moet de DATA instellen. SET_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist. |
NDIS_STATUS_FAILURE |
De aanvraag is om andere redenen mislukt. |
Eisen
Versie |
Ondersteund in NDIS 6.30 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |