struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS specifica una matrice di proprietà dei criteri per una porta commutatore estendibile Hyper-V. Ogni elemento della matrice viene formattato come struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO .

Sintassi

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_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_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
  USHORT                                   Reserved;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS . 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_ENUM_PARAMETERS , il membro Revision di Header deve essere impostato sul valore seguente:

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_ENUM_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 per cui vengono enumerate le proprietà.

PropertyType

Valore di enumerazione NDIS_SWITCH_PORT_PROPERTY_TYPE che specifica il tipo di proprietà della porta. Quando viene eseguita una richiesta di metodo OID di OID_SWITCH_PORT_PROPERTY_ENUM , l'estensione del commutatore estendibile restituisce le proprietà della porta che corrispondono a questo tipo di proprietà.

PropertyId

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

SerializationVersion

Valore NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION che identifica la versione del 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.

FirstPropertyOffset

Valore USHORT che specifica l'offset, in byte, al primo elemento NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO che segue la struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS . L'offset viene misurato dall'inizio della struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS fino all'inizio del primo elemento della matrice.

Nota Se il valore di NumProperties è zero, questo membro viene ignorato.

NumProperties

Valore ULONG che specifica il numero di elementi NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO che seguono la struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS .

Reserved

Riservato per utilizzi futuri.

Commenti

La struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS viene usata nelle richieste del metodo OID di OID_SWITCH_PORT_PROPERTY_ENUM. Una matrice di strutture NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO segue la struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_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.

Le estensioni del commutatore estendibile possono accedere alla prima struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO specificata dalla struttura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS usando la macro NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO .

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