estructura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS especifica los parámetros de una propiedad de directiva de un puerto de conmutador extensible de Hyper-V.

Sintaxis

typedef struct _NDIS_SWITCH_PORT_PROPERTY_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_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_SWITCH_PORT_PROPERTY_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_PARAMETERS , el miembro Revision de Header debe establecerse en el siguiente valor:

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_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 al que se asigna la propiedad.

PropertyType

Valor de enumeración NDIS_SWITCH_PORT_PROPERTY_TYPE que especifica el tipo de propiedad de puerto contenida en el búfer de propiedades.

PropertyId

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

Para obtener más información, vea la sección Comentarios.

Nota La extensión de conmutador extensible debe omitir este miembro a menos que el miembro PropertyType esté establecido en NdisSwitchPortPropertyTypeCustom.

PropertyVersion

Valor NDIS_SWITCH_OBJECT_VERSION que identifica la versión de 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.

PropertyInstanceId

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

PropertyBufferLength

Valor de ULONG que especifica el tamaño, en bytes, del búfer de propiedades.

PropertyBufferOffset

Valor de ULONG que especifica el desplazamiento, en bytes, en el búfer de propiedades que sigue a la estructura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . El desplazamiento se mide desde el principio de la estructura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS hasta el principio del búfer de propiedades.

Reserved

Reservado para uso futuro.

Comentarios

La estructura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS se usa en las siguientes solicitudes de conjunto de OID:

El búfer de propiedades contiene una estructura asociada al miembro PropertyType . El búfer de propiedades sigue la estructura NDIS_SWITCH_PORT_PROPERTY_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.

La extensión de conmutador extensible debe seguir estas directrices cuando procesa una estructura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS :

Si el miembro PropertyType se establece en NdisSwitchPortPropertyTypeSecurity, el búfer de propiedades tiene el formato de estructura NDIS_SWITCH_PORT_PROPERTY_SECURITY .
Si el miembro PropertyType se establece en NdisSwitchPortPropertyTypeVlan, el búfer de propiedades tiene el formato de estructura NDIS_SWITCH_PORT_PROPERTY_VLAN .
Si el miembro PropertyType se establece en NdisSwitchPortPropertyTypeProfile, el búfer de propiedades tiene el formato de estructura NDIS_SWITCH_PORT_PROPERTY_PROFILE .
Si el miembro PropertyType se establece en NdisSwitchPortPropertyTypeCustom, el miembro PropertyId debe establecerse en el valor GUID que creó el proveedor de software independiente (ISV) para la propiedad de puerto personalizada. El búfer de propiedades tiene el formato de una estructura de NDIS_SWITCH_PORT_PROPERTY_CUSTOM que contiene los parámetros de la propiedad de puerto personalizada definida por el ISV.

Las extensiones de conmutador extensible pueden acceder a la propiedad de puerto personalizada dentro de una estructura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS mediante la macro NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_GET_PROPERTY .

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