OID_RECEIVE_FILTER_QUEUE_PARAMETERS
Overlying drivers issue object identifier (OID) method requests of OID_RECEIVE_FILTER_QUEUE_PARAMETERS to obtain the current configuration parameters of a receive queue. De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_RECEIVE_QUEUE_PARAMETERS structuur met een wachtrij-id van het type NDIS_RECEIVE_QUEUE_ID. Nadat de OID-methodeaanvraag is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een NDIS_RECEIVE_QUEUE_PARAMETERS structuur.
Overliggende stuurprogramma's geven OID-setaanvragen van OID_RECEIVE_FILTER_QUEUE_PARAMETERS om de huidige configuratieparameters van een wachtrij te wijzigen. Het overliggende stuurprogramma biedt een aanwijzer naar een NDIS_RECEIVE_QUEUE_PARAMETERS structuur in de InformationBuffer lid van de NDIS_OID_REQUEST-structuur.
Opmerkingen
Overliggende stuurprogramma's geven OID-setaanvragen van OID_RECEIVE_FILTER_QUEUE_PARAMETERS om de parameters van een of meer ontvangstwachtrijen te wijzigen. De OID-setaanvraag is optioneel voor NDIS 6.20- en hoger minipoortstuurprogramma's. De OID-aanvraag is echter verplicht voor minipoortstuurprogramma's die ondersteuning bieden voor de VMQ-interface (Virtual Machine Queue).
Opmerking Alleen het stuurprogramma dat aan de wachtrij is toegewezen, kan de configuratieparameters wijzigen door OID-setaanvragen van OID_RECEIVE_FILTER_QUEUE_PARAMETERS uit te geven.
Het overliggende stuurprogramma heeft de invoerwaarde voor de wachtrij-id verkregen van een eerdere OID_RECEIVE_FILTER_ALLOCATE_QUEUE methode-OID-aanvraag.
Nadat het overliggende stuurprogramma een wachtrij heeft toegewezen, kan deze de configuratieparameters wijzigen met een bijbehorende wijzigingsvlag (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) in de Vlaggen lid van de NDIS_RECEIVE_QUEUE_PARAMETERS-structuur. Nadat de wachtrij is toegewezen, kan het overliggende stuurprogramma echter niet de configuratieparameters wijzigen die geen bijbehorende wijzigingsvlag hebben.
Statuscodes retourneren
NDIS verwerkt de OID-methodeaanvraag van OID_RECEIVE_FILTER_QUEUE_PARAMETERS voor minipoortstuurprogramma's en retourneert een van de volgende statuscodes.
| Statuscode | Beschrijving |
|---|---|
NDIS_STATUS_SUCCESS |
De aanvraag is voltooid. |
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.METHOD_INFORMATION.lid van BytesNeeded in de NDIS_OID_REQUEST-structuur tot de minimale buffergrootte die is vereist. |
NDIS_STATUS_INVALID_PARAMETER |
De aanvraag is mislukt omdat is geprobeerd een mogelijkheid in te schakelen die niet door de onderliggende netwerkadapter wordt ondersteund. |
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) |