NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS structure (ntddndis.h)

Article
05/26/2021

The NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS structure specifies an array of profile properties for the Hyper-V extensible switch. Each element in the array is formatted as an NDIS_SWITCH_PROPERTY_ENUM_INFO structure.

Syntax

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

The type, revision, and size of the NDIS_SWITCH_PROPERTY_ENUM_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_ENUM_PARAMETERS structure, the Revision member of Header must be set to the following value:

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1

Original version for NDIS 6.30 and later.

Set the Size member to NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_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 extensible switch property type. When an OID method request of OID_SWITCH_PROPERTY_ENUM is issued, the extensible switch extension returns extensible switch properties that match this property type.

PropertyId

A GUID value that identifies 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.

FirstPropertyOffset

A USHORT value that specifies the offset, in bytes, to the first NDIS_SWITCH_PROPERTY_ENUM_INFO element that follows the NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS structure. The offset is measured from the start of the NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS structure up to the beginning of the first element in the array.

Note If the value of NumProperties is zero, this member is ignored.

NumProperties

A ULONG value that specifies the number of NDIS_SWITCH_PROPERTY_ENUM_INFO elements that follow the NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS structure.

Remarks

The NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS structure is used in OID method requests of OID_SWITCH_PROPERTY_ENUM. An array of NDIS_SWITCH_PROPERTY_ENUM_INFO structures follows the NDIS_SWITCH_PROPERTY_ENUM_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.

Extensible switch extensions can access the first NDIS_SWITCH_PROPERTY_ENUM_INFO structure that is specified by the NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS structure by using the NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO 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)