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:
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.
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.
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 |