estructura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM (ntddndis.h)

Artículo
02/07/2025

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

Sintaxis

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              FeatureStatusBufferLength;
  ULONG              FeatureStatusBufferOffset;
} NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM, *PNDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM;

Miembros

Header

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

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

NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro tamaño de en NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM_REVISION_1.

Flags

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

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 de NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM. El desplazamiento se mide desde el principio de la estructura NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM hasta el principio del búfer de estado de la característica.

Observaciones

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 la información de estado de la característica que se va a devolver para un puerto de conmutador extensible. La extensión switch rellena el featureStatusVersion miembro 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 los datos de estado de la característica para el puerto de conmutador extensible especificado. La extensión switch rellena el FeatureStatusCustomBufferLength miembro 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.

El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a este búfer de información.