NDIS_SWITCH_PROPERTY_PARAMETERS struttura (ntddndis.h)

Articolo
03/05/2024

La struttura NDIS_SWITCH_PROPERTY_PARAMETERS specifica i parametri per una proprietà dei criteri di un commutatore estendibile Hyper-V.

Sintassi

typedef struct _NDIS_SWITCH_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_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;
} NDIS_SWITCH_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PROPERTY_PARAMETERS;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_SWITCH_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_PROPERTY_PARAMETERS , il membro Revision of Header deve essere impostato sul valore seguente:

NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_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à di commutatore estendibile contenuto nel buffer delle proprietà.

PropertyId

Valore GUID che identifica la proprietà 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 NdisSwitchPropertyTypeCustom.

PropertyVersion

Valore NDIS_SWITCH_OBJECT_VERSION che identifica la versione della proprietà di 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.

PropertyInstanceId

Valore NDIS_SWITCH_OBJECT_INSTANCE_ID che specifica l'identificatore dell'istanza della proprietà 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_PROPERTY_PARAMETERS . L'offset viene misurato dall'inizio della struttura NDIS_SWITCH_PROPERTY_PARAMETERS fino all'inizio del buffer delle proprietà.

Commenti

La struttura NDIS_SWITCH_PROPERTY_PARAMETERS viene usata nelle richieste del set OID seguenti:

Il buffer delle proprietà contiene una struttura associata al membro PropertyType . Il buffer delle proprietà segue la struttura NDIS_SWITCH_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.

Nota A partire da Windows Server 2012, il membro PropertyType deve essere impostato su NdisSwitchPropertyTypeCustom e il buffer delle proprietà deve contenere una struttura NDIS_SWITCH_PROPERTY_CUSTOM.

Le estensioni del commutatore estendibile possono accedere al buffer delle proprietà commutatore estendibile all'interno di una struttura NDIS_SWITCH_PROPERTY_PARAMETERS usando la macro NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY .

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