Standardisierte INF-Schlüsselwörter für VMQ

Die folgenden standardisierten INF-Schlüsselwörter werden definiert, um die Unterstützung für die VMQ-Features (Virtual Machine Queue) von Netzwerkadaptern zu aktivieren oder zu deaktivieren.

*VMQ
Ein Wert, der beschreibt, ob das Gerät das VMQ-Feature aktiviert oder deaktiviert hat.

*VMQLookaheadSplit
Ein Wert, der beschreibt, ob das Gerät die Möglichkeit zum Aufteilen von Puffern in Lookahead- und Nachschlageheadpuffer aktiviert oder deaktiviert hat. The miniport driver reports this capability with the NDIS_RECEIVE_FILTER_LOOKAHEAD_SPLIT_SUPPORTED flag in the SupportedQueueProperties member of the NDIS_RECEIVE_FILTER_CAPABILITIES structure. Weitere Informationen zu diesem Feature finden Sie unter Shared Memory in Receive Buffers.For more information about this feature, see Shared Memory in Receive Buffers.

Note Starting with NDIS 6.30, splitting packet data into separate lookahead buffers is no longer supported. Ab Windows Server 2012 ist dieses INF-Schlüsselwort veraltet.

*VMQVlanFiltering
Ein Wert, der beschreibt, ob das Gerät die Möglichkeit zum Filtern von Netzwerkpaketen mithilfe des VLAN-Bezeichners im MAC-Header (Media Access Control) aktiviert oder deaktiviert hat. The miniport driver reports this capability with the NDIS_RECEIVE_FILTER_MAC_HEADER_VLAN_ID_SUPPORTED flag in SupportedMacHeaderFields member of the NDIS_RECEIVE_FILTER_CAPABILITIES structure.

*RssOrVmqPreference
Ein Wert, der definiert, ob VMQ-Funktionen aktiviert werden sollen, anstatt RSS-Funktionen (Side Scaling) zu empfangen.

This is a hidden keyword value that must not be specified in the INF file and is not displayed in Advanced property page for the network adapter. Weitere Informationen finden Sie unter Behandeln von VMQ- und RSS-INF-Schlüsselwörtern.

VMQ standardisierte INF-Schlüsselwörter sind Enumerationsstichwörter. In der folgenden Tabelle werden die möglichen INF-Einträge für die standardisierten INF-Schlüsselwörter für VMQ beschrieben.

In den Spalten in dieser Tabelle werden die folgenden Attribute für ein Enumerationsstichwort beschrieben:

SubkeyName
Der Name des Schlüsselworts, das Sie in der INF-Datei angeben müssen. This name also appears in the registry under the NDI\params key for the network adapter.

ParamDesc
Der Anzeigetext, der dem InF-Eintrag "SubkeyName" zugeordnet ist.

Note The independent hardware vendor (IHV) can define any descriptive text for the SubkeyName.

Value
Der ganzzahlige Enumerationswert, der den einzelnen Unterschlüsselnamen in der Liste zugeordnet ist.

EnumDesc
The display text that is associated with each value that appears in the Advanced property page.

Weitere Informationen zu standardisierten INF-Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für Netzwerkgeräte.

Behandeln von VMQ- und RSS-INF-Schlüsselwörtern

Netzwerkadapter, die VMQ unterstützen und RSS (Side Scaling) empfangen, können diese Features nicht gleichzeitig verwenden. Das Betriebssystem ermöglicht die Verwendung der RSS- oder VMQ-Features auf folgende Weise:

• Wenn der Netzwerkadapter an den TCP/IP-Stapel gebunden ist, ermöglicht der Betrieb die Verwendung des RSS-Features.

• Wenn der Netzwerkadapter an den Hyper-V erweiterbaren Switchtreiberstapel gebunden ist, ermöglicht das Betriebssystem die Verwendung des VMQ-Features.

  Weitere Informationen finden Sie unter Hyper-V Extensible Switch.

Da der Netzwerkadapter nicht deaktiviert und dann erneut aktiviert wird, wenn er vom TCP/IP-Stapel getrennt und an den Hyper-V Treiberstapel (oder umgekehrt) gebunden ist, ist es für solche Netzwerkadapter nicht möglich, automatisch zwischen VMQ und RSS zu wechseln.

When NDIS calls the MiniportInitializeEx function, the miniport driver follows these steps before it reports its currently-enabled VMQ or RSS capabilities to NDIS:

1. The miniport driver reads the *RssOrVmqPreference keyword before reporting its currently-enabled capabilities to NDIS.

   If the value of the *RssOrVmqPreference keyword is 1, the miniport driver is configured for VMQ preference.

   If the value of the *RssOrVmqPreference keyword is zero or the keyword is not present, the miniport driver is configured for RSS preference.

2. If the miniport driver is configured for VMQ preference, it must read the *VMQ keyword to determine if VMQ is enabled on the network adapter. Wenn das Schlüsselwort auf 1 festgelegt ist, meldet der Treiber die derzeit aktivierten VMQ-Einstellungen. Weitere Informationen dazu, wie der Miniporttreiber VMQ-Einstellungen meldet, finden Sie unter Ermitteln der VMQ-Funktionen eines Netzwerkadapters.

   Weitere Informationen zu den VMQ-Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für VMQ.

   Note If the miniport driver is configured for VMQ preference, it must not read any of the RSS standardized keywords.

3. If the miniport driver is configured for RSS preference, it must read the *RSS keyword to determine if RSS is enabled on the network adapter. Wenn das Schlüsselwort auf 1 festgelegt ist, meldet der Treiber die aktuell aktivierten RSS-Einstellungen. For more information on how the miniport driver reports RSS settings, see RSS Configuration.

   Weitere Informationen zu den RSS-Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für RSS.

   Note If the miniport driver is configured for RSS preference, it must not read any of the VMQ standardized keywords.

In der folgenden Tabelle wird beschrieben, wie der Miniporttreiber RSS- oder VMQ-Einstellungen bestimmt und Funktionen basierend auf Registrierungsstichwörtern angibt:

Note The miniport driver must always report the complete RSS and VMQ hardware capabilities regardless of the values of these keywords. Diese Schlüsselworteinstellungen wirken sich nur darauf aus, wie der Treiber die derzeit aktivierten RSS- und VMQ-Funktionen meldet.

Reservierte Registrierungsstichwörter

Wenn der Miniporttreiber VMQ unterstützt und die VMQ-Schnittstelle auf dem Netzwerkadapter aktiviert ist, darf der Treiber die folgenden RSS INF-Einträge nicht lesen:

The miniport driver that supports VMQ must not read the following subkeys under the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\VMSMP\Parameters registry key.