estructura de NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS especifica los parámetros para la información de estado personalizada de un puerto de conmutador extensible de Hyper-V. Esta información se conoce como información de estado de características . El formato de esta información se define mediante el proveedor de software independiente (ISV).

La información de estado se especifica a través de una estructura de NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM y se devuelve a través de una solicitud de método OID de OID_SWITCH_PORT_FEATURE_STATUS_QUERY.

Sintaxis

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE     FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  ULONG                                    FeatureStatusBufferLength;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS;

Miembros

Header

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

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PORT_FEATURE_STATUS_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 especifica el identificador numérico de un puerto de conmutador extensible. Este valor identifica de forma única el puerto en el conmutador extensible para el que se va a devolver la información de estado de la característica.

FeatureStatusType

Valor de enumeración NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE que especifica el tipo de información de estado de una propiedad de perfil de puerto de conmutador extensible personalizada.

Nota A partir de NDIS 6.30, este miembro debe establecerse en NdisSwitchPortPropertyTypeCustom.

FeatureStatusId

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

FeatureStatusVersion

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

FeatureStatusInstanceId

Valor de NDIS_SWITCH_OBJECT_INSTANCE_ID que identifica la instancia de la información de estado de la característica para el puerto de conmutador extensible.

FeatureStatusBufferLength

Valor de ULONG que especifica el tamaño, en bytes, del búfer de estado de la característica.

FeatureStatusBufferOffset

Valor de ULONG que especifica el desplazamiento, en bytes, en el búfer de estado de la característica que sigue a la estructura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS . El búfer de estado de la característica contiene una estructura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM .

El desplazamiento se mide desde el principio de la estructura de NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS hasta el principio de la estructura de NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM .

Reserved

Reservado para uso futuro.

Comentarios

La estructura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS se usa en solicitudes de método OID de OID_SWITCH_PORT_FEATURE_STATUS_QUERY. Esta solicitud de OID devuelve las siguientes estructuras en el búfer de información asociado a la solicitud OID:

Estructura NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS que especifica los parámetros de una propiedad personalizada de un puerto de conmutador extensible para el que se va a devolver la información de estado. La extensión switch rellena el miembro FeatureStatusVersion de la estructura para reflejar la versión del estado personalizado que se devuelve en el búfer de NDIS_SWITCH_FEATURE_STATUS_CUSTOM. El conmutador extensible de Hyper-v rellena todos los demás miembros al emitir el OID de consulta.
Estructura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM que contiene la información de estado de la propiedad de puerto de conmutador extensible. La extensión switch rellena el miembro FeatureStatusCustomBufferLength de la estructura para reflejar el tamaño del estado personalizado que se devuelve. El conmutador extensible de Hyper-v rellena todos los demás miembros al emitir el OID de consulta.