Edit

Share via

NDIS_SWITCH_PROPERTY_ENUM_INFO structure (ntddndis.h)

  • Article

The NDIS_SWITCH_PROPERTY_ENUM_INFO structure specifies information about a profile property for the Hyper-V extensible switch.

Syntax

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PROPERTY_ENUM_INFO;

Members

Header

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

NDIS_SWITCH_PROPERTY_ENUM_INFO_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.

PropertyInstanceId

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

PropertyVersion

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

QwordAlignedPropertyBufferLength

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

PropertyBufferLength

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

Note  This value must be less than or equal to the value of the QwordAlignedPropertyBufferLength member.
 

PropertyBufferOffset

A ULONG value that specifies the offset, in bytes, to the property buffer that follows the NDIS_SWITCH_PROPERTY_ENUM_INFO 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_ENUM_INFO structure is used in OID set 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 next NDIS_SWITCH_PROPERTY_ENUM_INFO element that follows an NDIS_SWITCH_PROPERTY_ENUM_INFO structure in the array by using the NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_NEXT macro.

Extensible switch extensions can access the extensible switch property buffer that is specified by an NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO structure by using the NDIS_SWITCH_PROPERTY_ENUM_INFO_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)

See also

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_NEXT

NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_PROPERTY

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS

OID_SWITCH_PROPERTY_ENUM