OID_RECEIVE_FILTER_ENUM_FILTERS

2025-03-13

Een te bovenliggend stuurprogramma geeft een OID-methodeaanvraag van OID_RECEIVE_FILTER_ENUM_FILTERS op om een lijst te verkrijgen van alle filters die zijn geconfigureerd op een netwerkadapter.

De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_RECEIVE_FILTER_INFO_ARRAY structuur.

Nadat de OID-methodeaanvraag is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een buffer. Deze buffer is opgemaakt om het volgende te bevatten:

Een NDIS_RECEIVE_FILTER_INFO_ARRAY structuur waarmee een lijst met ontvangstfilters wordt opgegeven die momenteel zijn geconfigureerd op een minipoortstuurprogramma.
Een matrix van NDIS_RECEIVE_FILTER_INFO structuren. Elke structuur geeft de parameters op van een ontvangstfilter dat momenteel is geconfigureerd op een minipoortstuurprogramma.

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.

Bij het overliggen van stuurprogramma's of toepassingen worden aanvragen van OID_RECEIVE_FILTER_ENUM_FILTERS OID-methode aangevraagd om de ontvangenfilters op te sommen die zijn ingesteld op een netwerkadapter. Dit omvat ontvangstfilters die zijn ingesteld op een SR-IOV virtuele poort (VPort) of een VMQ-ontvangstwachtrij.

Aanvullende richtlijnen voor de NDIS Packet Coalescing Interface

Vanaf Windows Server 2012 ondersteunt NDIS-pakket samenvoegen alleen de standaard ontvangen wachtrij van een netwerkadapter.

Als u de ontvangen filters voor het samenvoegen van pakketten wilt inventariseren, moet het overliggende stuurprogramma de QueueId instellen lid van de NDIS_RECEIVE_FILTER_INFO_ARRAY-structuur op NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Aanvullende richtlijnen voor de SR-IOV-interface

Vanaf Windows Server 2012 ondersteunt de SR-IOV-interface alleen de standaardwachtrij voor ontvangst van een virtuele poort (VPort).

Als u de VPort-ontvangstfilters wilt opsommen, moet het overliggende stuurprogramma de QueueId lid van de NDIS_RECEIVE_FILTER_INFO_ARRAY-structuur instellen op NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Aanvullende richtlijnen voor de VMQ-interface

Een overliggend stuurprogramma kan OID-methodeaanvragen van OID_RECEIVE_FILTER_ENUM_FILTERS uitgeven om de ontvangen filters op te sommen die zijn ingesteld op een VMQ-ontvangstwachtrij. Wanneer het bovenliggende stuurprogramma de structuur van de NDIS_RECEIVE_FILTER_INFO_ARRAY initialiseert, wordt de QueueId lid ingesteld op een van de volgende waarden:

De waarde van de wachtrij-id voor een niet-standaard-ontvangstwachtrij. Het overliggende stuurprogramma heeft de invoerwaarde voor de wachtrij-id verkregen van een eerdere OID-methodeaanvraag van OID_RECEIVE_FILTER_ALLOCATE_QUEUE of een OID-queryaanvraag van OID_RECEIVE_FILTER_ENUM_QUEUES.
De waarde van de wachtrij-id van NDIS_DEFAULT_RECEIVE_QUEUE_ID, waarmee de standaardwachtrij voor ontvangst wordt opgegeven.

Statuscodes retourneren

NDIS verwerkt de OID-methodeaanvraag van OID_RECEIVE_FILTER_ENUM_FILTERS voor minipoortstuurprogramma's en retourneert een van de volgende statuscodes:

NDIS_STATUS_SUCCESS
De aanvraag is voltooid. De InformationBuffer verwijst naar een NDIS_RECEIVE_FILTER_INFO_ARRAY structuur.

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_INVALID_LENGTH
De informatiebuffer was te kort. NDIS stelt de DATA in. QUERY_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.