OID_PACKET_COALESCING_FILTER_MATCH_COUNT
NDIS geeft een OID-queryaanvraag van OID_PACKET_COALESCING_FILTER_MATCH_COUNT uit om het aantal pakketten te verkrijgen dat in de cache is opgeslagen, of samengevoegd, op de netwerkadapter. De netwerkadapter sluit pakketten samen als de adapter is ingeschakeld voor NDIS-pakket samenvoegen en het pakket overeenkomt met een ontvangstfilter.
De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een aanroeper toegewezen ULONG64 variabele. Voordat de queryaanvraag is geretourneerd, werkt het stuurprogramma de ULONG64 variabele bij met het aantal pakketten dat overeenkomt met ontvangen filters op de netwerkadapter.
Opmerkingen
Vanaf NDIS 6.30 moeten stuurprogramma's die ondersteuning bieden voor NDIS-pakketsamensmelten ondersteuning bieden voor OID-queryaanvragen van OID_PACKET_COALESCING_FILTER_MATCH_COUNT.
Let op Stuurprogramma's die ondersteuning bieden voor de I/O-virtualisatie met één hoofdmap (SR-IOV) of VMQ-interfaces (Virtual Machine Queue) die geen ondersteuning bieden voor OID-queryaanvragen van deze OID.
Een minipoortstuurprogramma dat ondersteuning biedt voor pakketvereniging, moet een ULONG64 teller verhogen voor elk ontvangen pakket dat op de netwerkadapter is gekoppeld. Pakketten worden gegroepeerd als ze overeenkomen met een ontvangstfilter, waardoor stuurprogramma's te veel worden gedownload naar het minipoortstuurprogramma via OID-methodeaanvragen van OID_RECEIVE_FILTER_SET_FILTER.
Het stuurprogramma retourneert de waarde van deze teller wanneer deze een OID-queryaanvraag van OID_PACKET_COALESCING_FILTER_MATCH_COUNT verwerkt.
Het minipoortstuurprogramma mag de teller niet wissen nadat deze de OID-queryaanvraag van OID_PACKET_COALESCING_FILTER_MATCH_COUNT heeft verwerkt. Het minipoortstuurprogramma mag alleen de teller wissen als aan de volgende voorwaarden wordt voldaan:
Het minipoortstuurprogramma verwerkt een OID-setaanvraag van OID_PNP_SET_POWER om door te gaan naar een volledige energiestatus van NdisDeviceStateD0.
NDIS roept de MiniportResetEx--functie van het minipoortstuurprogramma aan om de onderliggende netwerkadapter opnieuw in te stellen.
Zie NDIS Packet Coalescingvoor meer informatie over het samenvoegen van pakketten.
Statuscodes retourneren
Het minipoortstuurprogramma retourneert een van de volgende statuscodes voor de aanvraag van de OID-methode van OID_PACKET_COALESCING_FILTER_MATCH_COUNT:
NDIS_STATUS_SUCCESS
De OID-aanvraag is voltooid.
NDIS_STATUS_INVALID_LENGTH
De informatiebuffer was te kort. Het stuurprogramma stelt de DATA in. 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) |