NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES
Der Miniporttreiber gibt eine NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status Angabe aus, wann sich die derzeit aktivierten Empfangsfilterfunktionen ändern.
Hinweis Diese status Angabe sollte nur von Miniporttreibern gemacht werden, die NDIS-Empfangsfilter unterstützen.
Wenn der Miniporttreiber diese status Angabe macht, legt er das StatusBuffer-Element der NDIS_STATUS_INDICATION-Struktur auf einen Zeiger auf eine NDIS_RECEIVE_FILTER_CAPABILITIES-Struktur fest. Der Treiber initialisiert diese Struktur mit den aktuell aktivierten Empfangsfilterfunktionen.
Bemerkungen
NDIS-Empfangsfilter werden in den folgenden NDIS-Schnittstellen verwendet:
NDIS Packet Coalescing. Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Managing Packet Coalescing Receive Filters .
Single Root-E/A-Virtualisierung (SR-IOV) Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen eines Empfangsfilters für einen virtuellen Port.
Virtual Machine Queue (VMQ). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen und Löschen von VMQ-Filtern.
Der Miniporttreiber gibt die NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status Angabe aus, wenn eine der folgenden Bedingungen zutrifft:
Die derzeit aktivierten Empfangsfilterfunktionen ändern sich auf einem einzelnen Netzwerkadapter. Beispielsweise können Empfangsfilter über eine Verwaltungsanwendung aktiviert oder deaktiviert werden, die vom unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) entwickelt wurde.
Die derzeit aktivierten Empfangsfilterfunktionen ä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.
Der Miniporttreiber führt die folgenden Schritte aus, wenn er die NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status Hinweis ausgibt:
Der Miniport initialisiert die NDIS_RECEIVE_FILTER_CAPABILITIES-Struktur mit den Empfangsfilterfunktionen, die derzeit auf dem Netzwerkadapter aktiviert sind.
Wenn der Miniporttreiber das Headerelement initialisiert, legt er das Type-Element des Headers auf NDIS_OBJECT_TYPE_DEFAULT fest. Der Miniporttreiber legt das Revisionselement des Headers auf NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2 und das Size-Element auf NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2 fest.
Der Miniporttreiber initialisiert eine NDIS_STATUS_INDICATION-Struktur für die status-Angabe wie folgt:
Das StatusCode-Element muss auf NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES festgelegt werden.
Das StatusBuffer-Element muss auf die Adresse der NDIS_RECEIVE_FILTER_CAPABILITIES-Struktur festgelegt werden.
Das StatusBufferSize-Element muss auf
sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES)festgelegt werden.
Der Miniporttreiber gibt die status-Anzeige aus, indem er NdisMIndicateStatusEx aufruft. Der Treiber muss einen Zeiger auf die NDIS_STATUS_INDICATION-Struktur an den StatusIndication-Parameter übergeben.
Hinweis Überlastende Treiber können die NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status Indikation verwenden, um die derzeit aktivierten Empfangsfilterfunktionen des Netzwerkadapters zu ermitteln. Alternativ können diese Treiber auch OID-Abfrageanforderungen von OID_RECEIVE_FILTER_CURRENT_CAPABILITIES ausgeben, um die aktuell aktivierten Empfangsfilterfunktionen jederzeit abzurufen.
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ndis.h (einschließlich Ndis.h) |