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) |