struttura NDIS_SWITCH_PORT_PROPERTY_PROFILE (ntddndis.h)

Articolo
02/26/2024

La struttura NDIS_SWITCH_PORT_PROPERTY_PROFILE specifica una proprietà dei criteri per una porta commutatore estendibile Hyper-V salvata dall'estensione del commutatore estendibile nel proprio archivio criteri anziché nell'archivio criteri Hyper-V. In questo caso, le definizioni dei criteri vengono identificate dai profili di proprietà all'interno dell'archivio criteri del driver.

Sintassi

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;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SWITCH_PORT_PROPERTY_PROFILE . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il membro Type di Header deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_SWITCH_PORT_PROPERTY_PROFILE , il membro Revision di Header deve essere impostato sul valore seguente:

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

ProfileName

Valore NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME che specifica il nome descrittivo della proprietà del profilo.

ProfileId

Valore GUID che identifica in modo univoco la proprietà del profilo.

VendorName

Valore NDIS_VENDOR_NAME che specifica il nome descrittivo del fornitore che ha definito il profilo di porta.

VendorId

Valore GUID che identifica il fornitore che ha definito il profilo di porta.

ProfileData

NetCfgInstanceId

Valore GUID che specifica il valore del Registro di sistema NetCfgInstanceId della connessione alla scheda di rete sottostante per cui viene applicata la proprietà.

Il valore NetCfgInstanceId viene specificato per la connessione della scheda di rete tramite una richiesta di set OID (Object Identifier) di OID_SWITCH_NIC_CREATE.

PciLocation

Struttura che specifica il percorso PCI della scheda di rete fisica sottostante specificata dal membro NetCfgInstanceId .

Per altre informazioni, vedere la sezione Osservazioni.

PciLocation.PciSegmentNumber

Valore che specifica il gruppo di bus PCI in cui è collegata la scheda di rete fisica.

PciLocation.PciBusNumber

Valore che specifica il numero corrente del bus PCI in cui è collegata la scheda di rete fisica.

PciLocation.PciDeviceNumber

Valore che specifica il numero di dispositivo per la scheda di rete fisica nel bus PCI.

Nota Il numero di dispositivo PCI è noto anche come numero di slot PCI.

PciLocation.PciFunctionNumber

Valore che specifica il numero di funzione di un dispositivo logico nella scheda di rete fisica.

CdnLabelId

Valore UINT32 che specifica un identificatore univoco per i dati contenuti nel membro CdnLabel .

CdnLabel

Valore NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL che specifica l'etichetta CDN PCI Express (PCIe) per il percorso della scheda di rete fisica. Un'etichetta della rete CDN fornisce posizioni dei dispositivi coerenti in posizioni hardware simili.

Commenti

La struttura NDIS_SWITCH_PORT_PROPERTY_PROFILE viene usata dall'estensione per fare riferimento a una proprietà dei criteri all'interno di un archivio criteri privato invece dell'archivio criteri Hyper-V. In questo modo il fornitore di software indipendente (ISV) può popolare e gestire questo archivio criteri privato tramite canali privati e interfacce. I fornitori possono distinguere i profili da altri profili dei fornitori usando i campi VendorName e VendorId .

Nota Le proprietà dei criteri di porta specificate da una struttura NDIS_SWITCH_PORT_PROPERTY_PROFILE sono trasparenti per l'interfaccia del commutatore estendibile.

La struttura NDIS_SWITCH_PORT_PROPERTY_PROFILE viene usata nelle richieste di set OID seguenti:

La struttura NDIS_SWITCH_PORT_PROPERTY_PROFILE segue la struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS nel buffer associato a queste richieste di set OID. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a questo buffer.

Nota I tipi di dati NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME e NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL sono definiti dalla struttura IF_COUNTED_STRING . Non è necessario che una stringa definita da questa struttura sia con terminazione Null. Tuttavia, la lunghezza della stringa deve essere impostata nel membro Length di questa struttura. Se la stringa è con terminazione Null, il membro Length non deve includere il carattere Null di terminazione.

I membri PciLocation e CdnLabel sono rilevanti solo se il profilo di proprietà specifica un criterio per una scheda di rete fisica sottostante collegata alla scheda di rete esterna del commutatore estendibile. Ad esempio, se la scheda di rete esterna è associata a un team di adattatori estendibile, questi membri potrebbero specificare criteri per una singola scheda di tale team. Per altre informazioni sul team del commutatore estendibile, vedere Tipi di configurazioni delle schede di rete fisiche.