NDIS_SWITCH_PORT_PROPERTY_PARAMETERS struttura (ntddndis.h)

Articolo
02/27/2024

La struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS specifica i parametri per una proprietà dei criteri di una porta estendibile Hyper-V.

Sintassi

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

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

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1.

Flags

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

PortId

Valore NDIS_SWITCH_PORT_ID che contiene l'identificatore univoco della porta del commutatore estendibile a cui viene assegnata la proprietà.

PropertyType

Valore di enumerazione NDIS_SWITCH_PORT_PROPERTY_TYPE che specifica il tipo di proprietà di porta contenuto nel buffer delle proprietà.

PropertyId

Valore GUID che identifica la proprietà per la porta del commutatore estendibile.

Per altre informazioni, vedere la sezione Osservazioni.

Nota L'estensione del commutatore estendibile deve ignorare questo membro a meno che il membro PropertyType non sia impostato su NdisSwitchPortPropertyTypeCustom.

PropertyVersion

Valore NDIS_SWITCH_OBJECT_VERSION che identifica la versione della proprietà per la porta di commutatore estendibile.

SerializationVersion

Valore NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION che identifica la versione di formato dei dati della proprietà della porta serializzata. Questi dati vengono serializzati per l'accesso dall'estensione dal file MOF (Managed Object Format) che ha definito la proprietà.

Nota Per Windows Server 2012, il membro SerializationVersion deve essere impostato su NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

PropertyInstanceId

Valore NDIS_SWITCH_OBJECT_INSTANCE_ID che identifica l'istanza della proprietà per la porta del commutatore estendibile.

PropertyBufferLength

Valore ULONG che specifica le dimensioni, in byte, del buffer delle proprietà.

PropertyBufferOffset

Valore ULONG che specifica l'offset, in byte, nel buffer delle proprietà che segue la struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . L'offset viene misurato dall'inizio della struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS fino all'inizio del buffer delle proprietà.

Reserved

Riservato per utilizzi futuri.

Commenti

La struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS viene usata nelle richieste del set OID seguente:

Il buffer delle proprietà contiene una struttura associata al membro PropertyType . Il buffer delle proprietà segue la struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS nel buffer delle informazioni associato a queste richieste di set OID. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a questo buffer di informazioni.

L'estensione del commutatore estendibile deve seguire queste linee guida quando elabora una struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS :

Se il membro PropertyType è impostato su NdisSwitchPortPropertyTypeSecurity, il buffer della proprietà viene formattato come struttura NDIS_SWITCH_PORT_PROPERTY_SECURITY.
Se il membro PropertyType è impostato su NdisSwitchPortPropertyTypeVlan, il buffer della proprietà viene formattato come struttura NDIS_SWITCH_PORT_PROPERTY_VLAN.
Se il membro PropertyType è impostato su NdisSwitchPortPropertyTypeProfile, il buffer della proprietà viene formattato come struttura NDIS_SWITCH_PORT_PROPERTY_PROFILE .
Se il membro PropertyType è impostato su NdisSwitchPortPropertyTypeCustom, il membro PropertyId deve essere impostato sul valore GUID creato per la proprietà porta personalizzata. Il buffer delle proprietà viene formattato come struttura NDIS_SWITCH_PORT_PROPERTY_CUSTOM che contiene i parametri per la proprietà porta personalizzata, come definito dall'ISV.

Le estensioni del commutatore estendibile possono accedere alla proprietà porta personalizzata all'interno di una struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS usando la macro NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_GET_PROPERTY .

Per altre informazioni sui criteri di commutatore estendibili, vedere Criteri di commutatore estendibile Hyper-V.