NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS struttura (ntddndis.h)

Articolo
02/29/2024

La struttura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS specifica una matrice di proprietà del profilo per il commutatore estendibile Hyper-V. Ogni elemento della matrice viene formattato come struttura NDIS_SWITCH_PROPERTY_ENUM_INFO .

Sintassi

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
} NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PROPERTY_ENUM_PARAMETERS;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_SWITCH_PROPERTY_ENUM_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_PROPERTY_ENUM_PARAMETERS , è necessario impostare il membro Revisionedell'intestazione sul valore seguente:

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

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

PropertyType

Valore di enumerazione NDIS_SWITCH_PROPERTY_TYPE che specifica il tipo di proprietà commutatore estendibile. Quando viene emessa una richiesta di metodo OID di OID_SWITCH_PROPERTY_ENUM , l'estensione commutatore estendibile restituisce proprietà di commutatore estendibili che corrispondono a questo tipo di proprietà.

PropertyId

Valore GUID che identifica la proprietà del commutatore estendibile.

SerializationVersion

Valore NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION che identifica la versione di formato dei dati delle proprietà del commutatore estendibile serializzato. 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_PROPERTY_ENUM_INFO che segue la struttura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS . L'offset viene misurato dall'inizio della struttura NDIS_SWITCH_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_PROPERTY_ENUM_INFO che seguono la struttura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS .

Commenti

La struttura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS viene usata nelle richieste del metodo OID di OID_SWITCH_PROPERTY_ENUM. Una matrice di strutture NDIS_SWITCH_PROPERTY_ENUM_INFO segue la struttura NDIS_SWITCH_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 strutturaNDIS_SWITCH_PROPERTY_ENUM_INFO specificata dalla struttura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS usando la macro NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO.

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