NDIS_SWITCH_NIC_OID_REQUEST-Struktur (ntddndis.h)

  • Artikel

Die NDIS_SWITCH_NIC_OID_REQUEST-Struktur gibt die Informationen an, die zum Weiterleiten oder Erstellen von OID-Anforderungen erforderlich sind.

Syntax

typedef struct _NDIS_SWITCH_NIC_OID_REQUEST {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 Flags;
  NDIS_SWITCH_PORT_ID   SourcePortId;
  NDIS_SWITCH_NIC_INDEX SourceNicIndex;
  NDIS_SWITCH_PORT_ID   DestinationPortId;
  NDIS_SWITCH_NIC_INDEX DestinationNicIndex;
  PNDIS_OID_REQUEST     OidRequest;
} NDIS_SWITCH_NIC_OID_REQUEST, *PNDIS_SWITCH_NIC_OID_REQUEST;

Member

Header

Der Typ, die Revision und die Größe der NDIS_SWITCH_NIC_OID_REQUEST Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Das Type-Element von Header muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_NIC_OID_REQUEST-Struktur anzugeben, muss der Revisionsmember von Header auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1

Ursprüngliche Version für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SIZEOF_NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Dieses Element ist für NDIS reserviert.

SourcePortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Hyper-V-Switchports enthält, an den die OID-Anforderung ursprünglich ausgestellt wurde.

SourceNicIndex

Ein NDIS_SWITCH_NIC_INDEX Wert, der den Index des Quellnetzwerkadapters angibt, der mit dem erweiterbaren Quellswitchport verbunden ist, der vom SourcePortId-Member angegeben wird.

DestinationPortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Switchports enthält, an den die OID-Anforderung weitergeleitet werden soll.

DestinationNicIndex

Ein NDIS_SWITCH_NIC_INDEX Wert, der den Index des Zielnetzwerkadapters angibt, der mit dem erweiterbaren Switchport verbunden ist, der vom DestinationPortId-Member angegeben wird.

OidRequest

Ein Zeiger auf eine NDIS_OID_REQUEST-Struktur . Diese Struktur enthält die Daten für die OID-Anforderung, die an den Miniporttreiber des Netzwerkadapters weitergeleitet werden, der von den Membern DestinationPortId und DestinationNicIndex angegeben wird.

Hinweise

Die NDIS_SWITCH_NIC_OID_REQUEST-Struktur wird in OID-Methodenanforderungen von OID_SWITCH_NIC_REQUEST verwendet.

Eine Erweiterung kann OID-Anforderungen an zugrunde liegende physische Netzwerkadapter im erweiterbaren Switchtreiberstapel weiterleiten oder daraus erstellen. Dadurch kann eine Erweiterung die folgenden Aktionen ausführen:

  • Verwalten Sie die Konfiguration von Hardwareauslagerungen auf einem zugrunde liegenden physischen Adapter für die folgenden Auslagerungstechnologien:
    • Internetprotokollsicherheit (IPsec).
    • Virtualisierte Computerwarteschlange (VMQ).
    • E/A-Virtualisierung mit Einzelstamm (Single Root I/O Virtualization, SR-IOV)
  • Fragen Sie die Konfiguration eines zugrunde liegenden physischen Netzwerkadapters ab, indem Sie Standard-NDIS-OIDs ausstellen. Beispielsweise kann die Erweiterung eine OID-Abfrageanforderung von OID_802_3_CURRENT_ADDRESS ausstellen, um die aktuelle MAC-Adresse (Media Access Control) des Adapters abzurufen.
Richtlinien zum Ausgeben von OID-Anforderungen an zugrunde liegende physische Adapter finden Sie unter Verwalten von OID-Anforderungen an physische Netzwerkadapter.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.30 und höher.
Kopfzeile ntddndis.h (include Ndis.h)

Weitere Informationen

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

OID_SWITCH_NIC_REQUEST