NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES

Der Miniporttreiber gibt eine NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES Statusanzeige aus, wenn sich die aktuell aktivierten Filterfunktionen ändern.

Hinweis Diese Statusanzeige sollte nur von Miniporttreibern vorgenommen werden, die NDIS-Empfangsfilter unterstützen.

Wenn der Miniporttreiber diese Statusanzeige macht, legt er den StatusBuffer Member 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 I/O Virtualization (SR-IOV). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen eines Empfangsfilters für einen virtuellen Port.

• VMQ(Virtual Machine Queue). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Einstellung und Löschen von VMQ-Filtern.

Der Miniporttreiber gibt die NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES Statusanzeige aus, wenn eine der folgenden Bedingungen zutrifft:

• Die aktuell aktivierten Empfangsfilterfunktionen ändern sich auf einem einzelnen Netzwerkadapter. Beispielsweise können Empfangsfilter über eine vom unabhängigen Hardwareanbieter (IHV) entwickelte Verwaltungsanwendung aktiviert oder deaktiviert werden.

• Die aktuell aktivierten Empfangsfilterfunktionen ändern sich für mindestens eine Netzwerkadapter, die zu einem von einem MUX-Zwischentreiber verwalteten LBFO-Team (Load Balancing Failover) gehören. Weitere Informationen finden Sie unter NDIS MUX Intermediate Drivers.

Der Miniporttreiber folgt den folgenden Schritten, wenn er die NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES Statusanzeige ausgibt:

1. Der Miniport initialisiert die NDIS_RECEIVE_FILTER_CAPABILITIES Struktur mit den Empfangsfilterfunktionen, die derzeit auf dem Netzwerkadapter aktiviert sind.

   Wenn der Miniporttreiber das element Header initialisiert, wird der Type Member Header auf NDIS_OBJECT_TYPE_DEFAULT festgelegt. Der Miniporttreiber legt das element RevisionHeader- auf NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2 und das Size Member auf NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2 fest.

2. Der Miniporttreiber initialisiert eine NDIS_STATUS_INDICATION Struktur für die Statusanzeige auf folgende Weise:

   • Das StatusCode Member muss auf NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIESfestgelegt werden.

   • Das StatusBuffer Member muss auf die Adresse der NDIS_RECEIVE_FILTER_CAPABILITIES Struktur festgelegt werden.

   • Das StatusBufferSize Member muss auf sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES)festgelegt werden.

3. Der Miniporttreiber gibt die Statusanzeige durch Aufrufen NdisMIndicateStatusExaus. Der Treiber muss einen Zeiger an die NDIS_STATUS_INDICATION Struktur an den parameter StatusIndication übergeben.

Hinweis Übermäßigungstreiber die NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES Statusanzeige verwenden können, um die aktuell 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.

Anforderungen

Siehe auch

NdisMIndicateStatusEx

NDIS_STATUS_INDICATION

NDIS_RECEIVE_FILTER_CAPABILITIES

OID_RECEIVE_FILTER_CURRENT_CAPABILITIES