estructura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS especifica una matriz de propiedades de perfil para el conmutador extensible de Hyper-V. Cada elemento de la matriz tiene formato de estructura NDIS_SWITCH_PROPERTY_ENUM_INFO .

Sintaxis

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
} NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PROPERTY_ENUM_PARAMETERS;

Miembros

Header

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

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_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 de ULONG que contiene un OR bit a bit de marcas. Este miembro está reservado para NDIS.

PropertyType

Valor de enumeración NDIS_SWITCH_PROPERTY_TYPE que especifica el tipo de propiedad de conmutador extensible. Cuando se emite una solicitud de método OID de OID_SWITCH_PROPERTY_ENUM , la extensión de conmutador extensible devuelve propiedades de conmutador extensibles que coinciden con este tipo de propiedad.

PropertyId

Valor GUID que identifica la propiedad de conmutador extensible.

SerializationVersion

Valor de NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION que identifica la versión de formato de los datos de propiedad de conmutador extensible 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.

FirstPropertyOffset

Valor de USHORT que especifica el desplazamiento, en bytes, al primer elemento NDIS_SWITCH_PROPERTY_ENUM_INFO que sigue a la estructura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS . El desplazamiento se mide desde el principio de la estructura de NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS hasta el principio del primer elemento de la matriz.

Nota Si el valor de NumProperties es cero, se omite este miembro.

NumProperties

Valor ULONG que especifica el número de elementos de NDIS_SWITCH_PROPERTY_ENUM_INFO que siguen a la estructura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS .

Comentarios

La estructura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS se usa en las solicitudes de método 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 acceder a la primera estructura de NDIS_SWITCH_PROPERTY_ENUM_INFO especificada por la estructura de NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS mediante la macro NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO .

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