OID_GEN_ISOLATION_PARAMETERS

Artikel
06/15/2023

NDIS und überlastende Treiber stellen eine Objektbezeichneranforderung (Object Identifier, OID) von OID_GEN_ISOLATION_PARAMETERS aus, um die Parameter der Mehrinstanzenkonfiguration (Isolation) abzurufen, die auf dem Port eines VM-Netzwerkadapters festgelegt sind.

Obwohl jede Routingdomäne separat am Port konfiguriert ist, gibt diese OID Parameter für alle Routingdomänen in einer einzelnen Abfrage zurück.

Ein überlastender Treiber sollte diese OID in zwei Schritten ausstellen:

Io fragt die erforderliche Puffergröße ab, und geben Sie die OID-Abfrage mit dem Size-Member des Headerelements der NDIS_ISOLATION_PARAMETERS-Struktur aus, die auf NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1 festgelegt ist. (Siehe NDIS_STATUS_INVALID_LENGTH unten.)
Stellen Sie die OID mit einem InformationBuffer der erforderlichen Größe aus.

Wenn die OID-Abfrageanforderung erfolgreich abgeschlossen wurde, enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf einen Puffer. Dieser Puffer enthält die folgenden Daten in der Reihenfolge:

Eine NDIS_ISOLATION_PARAMETERS Struktur
Mindestens eine NDIS_ROUTING_DOMAIN_ENTRY-Strukturen , eine für jede Routingdomäne
Mindestens eine NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY Strukturen, gruppiert nach Routingdomäne

In jeder NDIS_ROUTING_DOMAIN_ENTRY-Struktur enthält das FirstIsolationInfoEntryOffset-Element den Offset vom Anfang des OID-Informationspuffers (d. h. dem Anfang des Puffers, auf den das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur verweist) bis zum ersten NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY für diese Routingdomäne. Der Offset im NextIsolationInfoEntryOffset-Element der letzten Struktur in der Liste ist 0.

Wenn keine Konfigurationsparameter für mehrere Mandanten auf dem VM-Netzwerkadapter festgelegt sind, legt der Netzwerkadapter-Miniporttreiber die DATA fest. QUERY_INFORMATION. BytesGeschriebenes Element der NDIS_OID_REQUEST-Struktur auf Null und gibt NDIS_STATUS_SUCCESS zurück. In diesem Fall die Daten innerhalb der DATEN. QUERY_INFORMATION. InformationBuffer-Member wird vom Miniporttreiber nicht geändert.

Bemerkungen

Rückgabestatuscodes

Der Miniporttreiber des VM-Netzwerkadapters gibt einen der folgenden status Codes für diese OID-Anforderung zurück:

Statuscode	BESCHREIBUNG
NDIS_STATUS_SUCCESS	Die OID-Anforderung wurde erfolgreich abgeschlossen.
NDIS_STATUS_INVALID_LENGTH	Die Länge des Informationspuffers ist zu klein, um die angeforderten Informationen zurückzugeben. Der Miniporttreiber des VM-Netzwerkadapters legt die DATA fest. METHOD_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße in Bytes.
NDIS_STATUS_FAILURE	Die Anforderung ist aus anderen Gründen fehlgeschlagen.