NDIS_SWITCH_PORT_PROPERTY_PROFILE Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur gibt eine Richtlinieneigenschaft für einen Hyper-V erweiterbaren Switchport an, den die erweiterbare Switcherweiterung im eigenen Richtlinienspeicher anstelle 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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SWITCH_PORT_PROPERTY_PROFILE Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Das element TypeHeader muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur anzugeben, muss das Revision Member der 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 den Size Member auf NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises ODER von Flags enthält. Dieses Mitglied 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 die NetCfgInstanceId Registrierungswert der zugrunde liegenden Netzwerkadapterverbindung angibt, für die die Eigenschaft angewendet wird.

Der NetCfgInstanceId- Wert wird für die Netzwerkadapterverbindung über eine OID-Setanforderung (Object Identifier) von OID_SWITCH_NIC_CREATEangegeben.

PciLocation

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

Weitere Informationen finden Sie im Abschnitt "Hinweise".

PciLocation.PciSegmentNumber

Ein Wert, der die Gruppe der PCI-Busse angibt, an denen der physische Netzwerkadapter angeschlossen ist.

PciLocation.PciBusNumber

Ein Wert, der die aktuelle PCI-Busnummer angibt, an der der physische Netzwerkadapter angeschlossen ist.

PciLocation.PciDeviceNumber

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

Hinweis Die PCI-Gerätenummer wird auch als PCI-Steckplatznummerbezeichnet.

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 Member enthalten sind.

CdnLabel

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

Bemerkungen

Die NDIS_SWITCH_PORT_PROPERTY_PROFILE Struktur wird von der Erweiterung verwendet, um auf eine Richtlinieneigenschaft innerhalb eines privaten Richtlinienspeichers zu verweisen, anstelle des Hyper-V Richtlinienspeichers. Dadurch kann der unabhängige Softwareanbieter (ISV) diesen privaten Richtlinienspeicher über private Kanäle und Schnittstellen auffüllen und verwalten. Anbieter können ihre Profile von den Profilen anderer Anbieter unterscheiden, indem sie die Felder VendorName und VendorId verwenden.

Hinweis portrichtlinieneigenschaften, die durch eine NDIS_SWITCH_PORT_PROPERTY_PROFILE-Struktur angegeben werden, transparent für die erweiterbare Switchschnittstelle sind.

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

Die NDIS_SWITCH_PORT_PROPERTY_PROFILE Struktur folgt der NDIS_SWITCH_PORT_PROPERTY_PARAMETERS Struktur im Puffer, die diesen OID-Setanforderungen zugeordnet ist. Das 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 durch die IF_COUNTED_STRING-Struktur typdefiniert. Eine durch diese Struktur definierte Zeichenfolge muss nicht null beendet werden. Die Länge der Zeichenfolge muss jedoch im Length Member dieser Struktur festgelegt werden. Wenn die Zeichenfolge null-beendet ist, darf das element Length nicht das endende Nullzeichen enthalten.

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