estructura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS especifica los parámetros para la información de estado personalizada de un 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_FEATURE_STATUS_CUSTOM que se devuelve a través de una solicitud de método de identificador de objeto (OID) de OID_SWITCH_FEATURE_STATUS_QUERY.

Sintaxis

typedef struct _NDIS_SWITCH_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_FEATURE_STATUS_TYPE          FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    FeatureStatusBufferLength;
} NDIS_SWITCH_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_FEATURE_STATUS_PARAMETERS;

Miembros

Header

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

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1.

Flags

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

FeatureStatusType

Valor de enumeración NDIS_SWITCH_FEATURE_STATUS_TYPE que especifica el tipo de información de estado de la característica para el conmutador extensible.

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

FeatureStatusId

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

Este valor se define en la definición de clase de formato de objeto administrado (MOF) para la información de estado de la característica. Para obtener más información, vea Custom Switch Property Definition and Registration.

FeatureStatusInstanceId

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

FeatureStatusVersion

Valor de NDIS_SWITCH_OBJECT_VERSION que identifica la versión de la información de estado de la característica para el conmutador extensible. Este valor se define en la definición de clase MOF para la información de estado de la característica.

SerializationVersion

Valor de NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION que identifica la versión de formato de la información de estado serializada para la información de estado de la característica. Esta información se serializa para el acceso mediante la extensión desde el archivo MOF que definió la propiedad .

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

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_FEATURE_STATUS_PARAMETERS . El búfer de estado contiene una estructura de NDIS_SWITCH_FEATURE_STATUS_CUSTOM .

El desplazamiento se mide desde el principio de la estructura de NDIS_SWITCH_FEATURE_STATUS_PARAMETERS hasta el principio de la estructura NDIS_SWITCH_FEATURE_STATUS_CUSTOM .

FeatureStatusBufferLength

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

Comentarios

La estructura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS se usa en las solicitudes de método OID de OID_SWITCH_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_FEATURE_STATUS_PARAMETERS que especifica los parámetros de estado de la información de estado de la característica del conmutador extensible. 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_FEATURE_STATUS_CUSTOM que contiene la información de estado de la característica para el 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.