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.
NDIS-protocolstuurprogramma's geven object-id(OID)-methodeaanvragen van OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE op de hoogte van het minipoortstuurprogramma dat een toewijzing is voltooid voor de huidige batch van ontvangstwachtrijen.
De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY structuur die wordt gevolgd door een NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS structuur voor elke wachtrij. Nadat de OID-methodeaanvraag is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar dezelfde matrix met structuren en bevat de CompletionStatus lid van elke NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS structuur de voltooiingsstatus voor elke wachtrij.
Opmerkingen
De OID-methodeaanvraag van OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE is optioneel voor NDIS 6.20- en hoger minipoortstuurprogramma's. Het is verplicht voor minipoortstuurprogramma's die ondersteuning bieden voor de VMQ-interface (Virtual Machine Queue).
Nadat een of meer wachtrijen zijn toegewezen en eventueel de initiële filters zijn ingesteld, moet het protocolstuurprogramma de aanvraag van de OID-methode van OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE geven om het minipoortstuurprogramma op de hoogte te stellen dat de toewijzing is voltooid voor de huidige batch ontvangstwachtrijen. Hierdoor kan het minipoortstuurprogramma de hardwarebronnen verdelen over meerdere ontvangstwachtrijen; indien nodig kunnen resources, zoals gedeeld geheugen, worden toegewezen voor de ontvangstwachtrijen.
Nadat een minipoortstuurprogramma een OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE aanvraag heeft ontvangen en er filters zijn ingesteld voor de wachtrij, heeft de wachtrij de status Actief. In deze status kan het minipoortstuurprogramma indicaties van pakketten in de wachtrij starten door NdisMIndicateReceiveNetBufferListsaan te roepen.
Statuscodes retourneren
Het minipoortstuurprogramma retourneert een van de volgende statuscodes voor de aanvraag van de OID-methode van OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE.
| Statuscode | Beschrijving |
|---|---|
NDIS_STATUS_SUCCESS |
De toewijzing van de wachtrij is voltooid. De informatiebuffer bevat de bijgewerkte NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY structuur en parameterstructuren met de voltooiingsstatus voor de wachtrijtoewijzing. |
NDIS_STATUS_PENDING |
De aanvraag is in behandeling. De laatste statuscode en resultaten worden doorgegeven aan de voltooiingshandler van de OID-aanvraag van de aanroeper. |
NDIS_STATUS_INVALID_PARAMETER |
Een of meer van de parameters die door het opgegeven stuurprogramma te veel zijn opgegeven, zijn ongeldig. |
NDIS_STATUS_INVALID_LENGTH |
De informatiebuffer was te kort. NDIS stelt de DATA-in.METHOD_INFORMATION.lid van BytesNeeded in de NDIS_OID_REQUEST-structuur tot de minimale buffergrootte die is vereist. |
NDIS_STATUS_NOT_SUPPORTED |
De NDIS-versie van het minipoortstuurprogramma is ouder dan versie 6.20. |
NDIS_STATUS_FAILURE |
De aanvraag is om andere redenen mislukt. |
Eisen
Versie |
Ondersteund in NDIS 6.20 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |
Zie ook
NdisMIndicateReceiveNetBufferLists