NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur (ntddndis.h)

Artikel
02/26/2024

Die NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur gibt eine Richtlinieneigenschaft für einen erweiterbaren Hyper-V-Switchport an, den die erweiterbare Switcherweiterung in ihrem eigenen Richtlinienspeicher und nicht im Hyper-V-Richtlinienspeicher speichert. In diesem Fall werden Richtliniendefinitionen durch Eigenschaftenprofile im Richtlinienspeicher des Treibers identifiziert.

Syntax

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PROFILE {
  NDIS_OBJECT_HEADER                          Header;
  ULONG                                       Flags;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME      ProfileName;
  GUID                                        ProfileId;
  NDIS_VENDOR_NAME                            VendorName;
  GUID                                        VendorId;
  UINT32                                      ProfileData;
  GUID                                        NetCfgInstanceId;
  struct {
    UINT32 PciSegmentNumber : 16;
    UINT32 PciBusNumber : 8;
    UINT32 PciDeviceNumber : 5;
    UINT32 PciFunctionNumber : 3;
  } PciLocation;
  UINT32                                      CdnLabelId;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL CdnLabel;
} NDIS_SWITCH_PORT_PROPERTY_PROFILE, *PNDIS_SWITCH_PORT_PROPERTY_PROFILE;

Member

Header

Typ, Revision und Größe der NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur . Dieser Member 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_PORT_PROPERTY_PROFILE-Struktur anzugeben, muss der Revisionsmember von Header auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

Originalversion für NDIS 6.30 und höher.

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

Flags

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

ProfileName

Ein NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME Wert, der den benutzerfreundlichen Namen der Profileigenschaft angibt.

ProfileId

Ein GUID-Wert, der die Profileigenschaft eindeutig identifiziert.

VendorName

Ein NDIS_VENDOR_NAME Wert, der den benutzerfreundlichen Namen des Anbieters angibt, der das Portprofil definiert hat.

VendorId

Ein GUID-Wert, der den Anbieter identifiziert, der das Portprofil definiert hat.

ProfileData

NetCfgInstanceId

Ein GUID-Wert, der den NetCfgInstanceId-Registrierungswert der zugrunde liegenden Netzwerkadapterverbindung angibt, auf die die Eigenschaft angewendet wird.

Der NetCfgInstanceId-Wert wird für die Netzwerkadapterverbindung über eine Objektbezeichner-Setanforderung (OID) von OID_SWITCH_NIC_CREATE angegeben.

PciLocation

Eine -Struktur, die den PCI-Speicherort des zugrunde liegenden physischen Netzwerkadapters angibt, der vom NetCfgInstanceId-Member angegeben wird.

Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

PciLocation.PciSegmentNumber

Ein -Wert, der die Gruppe von PCI-Bussen angibt, an die der physische Netzwerkadapter angefügt ist.

PciLocation.PciBusNumber

Ein -Wert, der die aktuelle PCI-Busnummer angibt, an die der physische Netzwerkadapter angefügt ist.

PciLocation.PciDeviceNumber

Ein -Wert, der die Gerätenummer für den physischen Netzwerkadapter im PCI-Bus angibt.

Hinweis Die PCI-Gerätenummer wird auch als PCI-Steckplatznummer bezeichnet.

PciLocation.PciFunctionNumber

Ein -Wert, der die Funktionsnummer eines logischen Geräts auf dem physischen Netzwerkadapter angibt.

CdnLabelId

Ein UINT32-Wert, der einen eindeutigen Bezeichner für die Daten angibt, die im CdnLabel-Element enthalten sind.

CdnLabel

Ein NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL Wert, der die CDN-Bezeichnung PCI Express (PCIe) für den Speicherort des physischen Netzwerkadapters angibt. Eine CDN-Bezeichnung bietet konsistente Gerätestandorte an ähnlichen Hardwarestandorten.

Hinweise

Die NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur wird von der Erweiterung verwendet, um auf eine Richtlinieneigenschaft in einem privaten Richtlinienspeicher anstelle des Hyper-V-Richtlinienspeichers zu verweisen. Dadurch kann der unabhängige Softwarehersteller (Independent Software Vendor, ISV) diesen privaten Richtlinienspeicher über private Kanäle und Schnittstellen auffüllen und verwalten. Anbieter können ihre Profile mit den Feldern VendorName und VendorId von den Profilen anderer Anbieter unterscheiden.

Hinweis Portrichtlinieneigenschaften, die von einer NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur angegeben werden, sind für die erweiterbare Switchschnittstelle transparent.

Die NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur wird in den folgenden OID-Satzanforderungen verwendet:

Die NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur folgt der NDIS_SWITCH_PORT_PROPERTY_PARAMETERS-Struktur im Puffer, der diesen OID-Mengenanforderungen zugeordnet ist. Der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diesen Puffer.

Hinweis Die Datentypen NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME und NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL werden von der IF_COUNTED_STRING-Struktur typdefiniert. Eine Zeichenfolge, die von dieser Struktur definiert wird, muss nicht NULL-endend sein. Die Länge der Zeichenfolge muss jedoch im Length-Member dieser Struktur festgelegt werden. Wenn die Zeichenfolge NULL-endend ist, darf der Length-Member nicht das abschließende NULL-Zeichen enthalten.

Die Mitglieder PciLocation und CdnLabel sind nur relevant, wenn das Eigenschaftenprofil eine Richtlinie für einen zugrunde liegenden physischen Netzwerkadapter angibt, der an den externen Netzwerkadapter des erweiterbaren Switches angefügt ist. Wenn der externe Netzwerkadapter beispielsweise an ein erweiterbares Switchteam von Adaptern gebunden ist, können diese Mitglieder Richtlinien für einen einzelnen Adapter dieses Teams angeben. Weitere Informationen zum erweiterbaren Switch-Team finden Sie unter Typen von Konfigurationen physischer Netzwerkadapter.