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