Auf Englisch lesen

Freigeben über


NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS

Die NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status gibt für NDIS und überlastende Treiber an, dass sich die aktuellen VM-Warteschlangenparameter auf dem Netzwerkadapter geändert haben.

Bemerkungen

Der Miniporttreiber muss eine NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status Angabe ausgeben, wenn sich die aktuellen VM-Warteschlangenparameter auf dem Netzwerkadapter geändert haben. Die VM-Warteschlangenparameter können sich ändern, wenn eine der folgenden Bedingungen zutrifft:

  • Die VM-Warteschlangenparameter werden durch eine Verwaltungsanwendung geändert, die vom unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) entwickelt wurde.

  • Die VM-Warteschlangenparameter ändern sich für einen oder mehrere Netzwerkadapter, die zu einem LBFO-Team (Load Balancing Failover) gehören, das von einem MUX-Zwischentreiber verwaltet wird. Weitere Informationen finden Sie unter NDIS MUX Intermediate Drivers.

Wenn der Miniporttreiber die NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status Angabe ausgibt, müssen die folgenden Schritte ausgeführt werden:

  1. Der Miniporttreiber initialisiert eine NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur mit den aktuellen VM-Warteschlangenparametern auf dem Netzwerkadapter. Der Treiber muss auch den Flags-Member dieser Struktur mit den entsprechenden NDIS_RECEIVE_QUEUE_PARAMETERS_Xxx_CHANGED-Flags festlegen, um NDIS_RECEIVE_QUEUE_PARAMETERS geänderten Memberwerte zu melden.

    Hinweis Ab NDIS 6.30 kann der Miniporttreiber nur einen NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status Anzeigen ausgeben, um Änderungen am InterruptCoalescingDomainId-Member zu melden.

Wenn der Miniporttreiber das Headerelement dieser Struktur initialisiert, legt er das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT fest. Der Miniporttreiber legt den Revisionsmember des Headers auf NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2 und das Element Größe auf NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2 fest.

  1. Der Miniporttreiber initialisiert eine NDIS_STATUS_INDICATION-Struktur wie folgt:

    • Das StatusCode-Element muss auf NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS festgelegt werden.

    • Das StatusBuffer-Element muss auf den Zeiger auf eine NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur festgelegt werden. Diese Struktur enthält die derzeit aktivierten Hardwarefunktionen des NIC-Switches.

    • Das StatusBufferSize-Element muss auf sizeof(NDIS_RECEIVE_QUEUE_PARAMETERS) festgelegt werden.

  2. Der Miniporttreiber gibt die status-Benachrichtigung aus, indem er NdisMIndicateStatusEx aufruft. Der Treiber muss einen Zeiger auf die NDIS_STATUS_INDICATION-Struktur an den StatusIndication-Parameter übergeben.

Überlastende Treiber können die NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status Indikation verwenden, um die aktuellen VM-Warteschlangenparameter auf dem Netzwerkadapter zu bestimmen. Alternativ können diese Treiber auch Objektbezeichnerabfrageanforderungen (OID) von OID_RECEIVE_FILTER_QUEUE_PARAMETERS ausgeben, um diese Parameter jederzeit abzurufen.

Requirements (Anforderungen)

Version

Unterstützt in NDIS 6.30 und höher.

Header

Ndis.h

Weitere Informationen


NDIS_RECEIVE_QUEUE_PARAMETERS

NDIS_STATUS_INDICATION

OID_RECEIVE_FILTER_QUEUE_PARAMETERS