OID_RECEIVE_FILTER_QUEUE_PARAMETERS

Überlastende Treiber stellen OID-Methodenanforderungen (Object Identifier) von OID_RECEIVE_FILTER_QUEUE_PARAMETERS aus, um die aktuellen Konfigurationsparameter einer Empfangswarteschlange abzurufen. Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur mit einem Warteschlangenbezeichner vom Typ NDIS_RECEIVE_QUEUE_ID. Nach erfolgreicher Rückgabe der OID-Methodenanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur .

Überlastende Treiber geben OID-Set-Anforderungen von OID_RECEIVE_FILTER_QUEUE_PARAMETERS aus, um die aktuellen Konfigurationsparameter einer Warteschlange zu ändern. Der überlastende Treiber stellt einen Zeiger auf eine NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur im InformationBuffer-Member der NDIS_OID_REQUEST-Struktur bereit.

Bemerkungen

Überlastende Treiber geben OID-Setanforderungen von OID_RECEIVE_FILTER_QUEUE_PARAMETERS aus, um die Parameter einer oder mehrerer Empfangswarteschlangen zu ändern. Die Anforderung für den OID-Satz ist optional für Miniporttreiber NDIS 6.20 und höher. Die OID-Anforderung ist jedoch für Miniporttreiber obligatorisch, die die VMQ-Schnittstelle (VMQ) unterstützen.

Hinweis Nur der überlastende Treiber, der die Warteschlange zugeordnet hat, kann die Konfigurationsparameter ändern, indem OID-Satzanforderungen von OID_RECEIVE_FILTER_QUEUE_PARAMETERS ausgegeben werden.

Der überlastende Treiber hat den Warteschlangenbezeichner-Eingabewert aus einer früheren OID_RECEIVE_FILTER_ALLOCATE_QUEUE OID-Anforderung der Methode abgerufen.

Nachdem der überlastende Treiber eine Warteschlange zugewiesen hat, kann er die Konfigurationsparameter ändern, die über ein entsprechendes Änderungsflag (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) im Flags-Member der NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur verfügen. Nachdem die Warteschlange zugewiesen wurde, kann der überlastende Treiber die Konfigurationsparameter nicht ändern, die kein entsprechendes Änderungsflag aufweisen.

Rückgabestatuscodes

NDIS verarbeitet die OID-Methodenanforderung von OID_RECEIVE_FILTER_QUEUE_PARAMETERS für Miniporttreiber und gibt einen der folgenden status-Codes zurück.

Statuscode BESCHREIBUNG

NDIS_STATUS_SUCCESS

Die Anforderung wurde erfolgreich abgeschlossen.

NDIS_STATUS_PENDING

Die Anforderung steht aus. NDIS übergibt den endgültigen status Code und die Ergebnisse an den OID-Anforderungsvervollständigungshandler des Aufrufers, nachdem die Anforderung abgeschlossen wurde.

NDIS_STATUS_INVALID_LENGTH

Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. METHOD_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_INVALID_PARAMETER

Fehler bei der Anforderung, weil versucht wurde, eine Funktion zu aktivieren, die vom zugrunde liegenden Netzwerkadapter nicht unterstützt wird.

NDIS_STATUS_FAILURE

Die Anforderung ist aus anderen Gründen fehlgeschlagen.

Requirements (Anforderungen)

Version

Unterstützt in NDIS 6.20 und höher.

Header

Ntddndis.h (include Ndis.h)

Weitere Informationen

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_PARAMETERS

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS