NDIS_SWITCH_PROPERTY_PARAMETERS structure (ntddndis.h)

Article
05/26/2021

The NDIS_SWITCH_PROPERTY_PARAMETERS structure specifies the parameters for a policy property of a Hyper-V extensible switch.

Syntax

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

The type, revision, and size of the NDIS_SWITCH_PROPERTY_PARAMETERS structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The Type member of Header must be set to NDIS_OBJECT_TYPE_DEFAULT. To specify the version of the NDIS_SWITCH_PROPERTY_PARAMETERS structure, the Revision member of Header must be set to the following value:

NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1

Original version for NDIS 6.30 and later.

Set the Size member to NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1.

Flags

A ULONG value that contains a bitwise OR of flags. This member is reserved for NDIS.

PropertyType

An NDIS_SWITCH_PROPERTY_TYPE enumeration value that specifies the type of extensible switch property that is contained within the property buffer.

PropertyId

A GUID value that identifies the extensible switch property.

For more information, see the Remarks section.

Note The extensible switch extension must ignore this member unless the PropertyType member is set to NdisSwitchPropertyTypeCustom.

PropertyVersion

An NDIS_SWITCH_OBJECT_VERSION value that identifies the version of the extensible switch property.

SerializationVersion

An NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION value that identifies the format version of the serialized extensible switch property data. This data is serialized for access by the extension from the Managed Object Format (MOF) file that defined the property.

Note For Windows Server 2012, the SerializationVersion member must be set to NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

PropertyInstanceId

An NDIS_SWITCH_OBJECT_INSTANCE_ID value that specifies the instance identifier of the extensible switch property.

PropertyBufferLength

A ULONG value that specifies the size, in bytes, of the property buffer.

PropertyBufferOffset

A ULONG value that specifies the offset, in bytes, to the property buffer that follows the NDIS_SWITCH_PROPERTY_PARAMETERS structure. The offset is measured from the start of the NDIS_SWITCH_PROPERTY_PARAMETERS structure up to the beginning of the property buffer.

Remarks

The NDIS_SWITCH_PROPERTY_PARAMETERS structure is used in the following OID set requests:

The property buffer contains a structure that is associated with the PropertyType member. The property buffer follows the NDIS_SWITCH_PROPERTY_PARAMETERS structure in the information buffer that is associated with these OID set requests. The InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to this information buffer.

Note Starting with Windows Server 2012, the PropertyType member must be set to NdisSwitchPropertyTypeCustom and the property buffer must contain an NDIS_SWITCH_PROPERTY_CUSTOM structure.

Extensible switch extensions can access the extensible switch property buffer inside an NDIS_SWITCH_PROPERTY_PARAMETERS structure by using the NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY macro.

For more information about extensible switch policies, see Hyper-V Extensible Switch Policies.

Requirements

Requirement	Value
Minimum supported client	Supported in NDIS 6.30 and later.
Header	ntddndis.h (include Ndis.h)