estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS (ntddndis.h)

Artículo
08/07/2023

La estructura de NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS especifica una matriz de propiedades de directiva para un puerto de conmutador extensible de Hyper-V. Cada elemento de la matriz tiene el formato de estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO .

Sintaxis

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
  USHORT                                   Reserved;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS . Este miembro tiene formato de estructura NDIS_OBJECT_HEADER .

El miembro Type de Header debe establecerse en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS , el miembro Revision de Header debe establecerse en el siguiente valor:

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

Valor de ULONG que contiene un OR bit a bit de marcas. Este miembro está reservado para NDIS.

PortId

Valor de NDIS_SWITCH_PORT_ID que contiene el identificador único del puerto de conmutador extensible para el que se enumeran las propiedades.

PropertyType

Valor de enumeración NDIS_SWITCH_PORT_PROPERTY_TYPE que especifica el tipo de propiedad de puerto. Cuando se emite una solicitud de método OID de OID_SWITCH_PORT_PROPERTY_ENUM , la extensión de conmutador extensible devuelve propiedades de puerto que coinciden con este tipo de propiedad.

PropertyId

Valor GUID que identifica la propiedad para el puerto de conmutador extensible.

SerializationVersion

Valor de NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION que identifica la versión de formato de los datos de propiedad de puerto serializados. Esta información se serializa para el acceso mediante la extensión desde el archivo Managed Object Format (MOF) que definió la propiedad .

Nota Para Windows Server 2012, el miembro SerializationVersion debe establecerse en NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

FirstPropertyOffset

Valor de USHORT que especifica el desplazamiento, en bytes, al primer elemento NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO que sigue a la estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS . El desplazamiento se mide desde el principio de la estructura de NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS hasta el principio del primer elemento de la matriz.

Nota Si el valor de NumProperties es cero, se omite este miembro.

NumProperties

Valor de ULONG que especifica el número de NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO elementos que siguen a la estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS .

Reserved

Reservado para uso futuro.

Comentarios

La estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS se usa en solicitudes de método OID de OID_SWITCH_PORT_PROPERTY_ENUM. Una matriz de estructuras de NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO sigue la estructura NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS en el búfer de información asociado a estas solicitudes de conjunto de OID. El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a este búfer de información.

Las extensiones de conmutador extensible pueden acceder a la primera estructura de NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO especificada por la estructura de NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS mediante la macro NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO .

Para obtener más información sobre las directivas de conmutador extensible, consulte Directivas de conmutador extensible de Hyper-V.