estructura NDIS_SWITCH_PROPERTY_ENUM_INFO (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_SWITCH_PROPERTY_ENUM_INFO especifica información sobre una propiedad de perfil para el conmutador extensible de Hyper-V.

Sintaxis

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PROPERTY_ENUM_INFO;

Miembros

Header

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

NDIS_SWITCH_PROPERTY_ENUM_INFO_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

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

PropertyInstanceId

Valor NDIS_SWITCH_OBJECT_INSTANCE_ID que especifica el identificador de instancia de la propiedad de conmutador extensible.

PropertyVersion

Valor NDIS_SWITCH_OBJECT_VERSION que identifica la versión de la propiedad para el puerto de conmutador extensible.

QwordAlignedPropertyBufferLength

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

PropertyBufferLength

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

Nota Este valor debe ser menor o igual que el valor del miembro QwordAlignedPropertyBufferLength .

PropertyBufferOffset

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

Comentarios

La estructura NDIS_SWITCH_PROPERTY_ENUM_INFO se usa en las solicitudes de conjunto de OID de OID_SWITCH_PROPERTY_ENUM. Una matriz de estructuras de NDIS_SWITCH_PROPERTY_ENUM_INFO sigue la estructura NDIS_SWITCH_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 tener acceso al siguiente elemento NDIS_SWITCH_PROPERTY_ENUM_INFO que sigue a una estructura de NDIS_SWITCH_PROPERTY_ENUM_INFO de la matriz mediante la macro NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_NEXT .

Las extensiones de conmutador extensible pueden tener acceso al búfer de propiedades de conmutador extensible especificado por una estructura de NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO mediante la macro NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_PROPERTY .

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