estructura NDIS_SWITCH_PROPERTY_PARAMETERS (ntddndis.h)

Artículo
02/26/2024

La estructura NDIS_SWITCH_PROPERTY_PARAMETERS especifica los parámetros de una propiedad de directiva de un conmutador extensible de Hyper-V.

Sintaxis

typedef struct _NDIS_SWITCH_PROPERTY_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PROPERTY_TYPE                PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PROPERTY_PARAMETERS;

Miembros

Header

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

NDIS_SWITCH_PROPERTY_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_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 contenida en el búfer de propiedades.

PropertyId

Valor GUID que identifica la propiedad de conmutador extensible.

Para obtener más información, vea la sección Comentarios.

Nota La extensión de conmutador extensible debe omitir este miembro a menos que el miembro PropertyType esté establecido en NdisSwitchPropertyTypeCustom.

PropertyVersion

Valor NDIS_SWITCH_OBJECT_VERSION que identifica la versión de la propiedad extensible switch.

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.

PropertyInstanceId

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

PropertyBufferLength

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

PropertyBufferOffset

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

Comentarios

La estructura NDIS_SWITCH_PROPERTY_PARAMETERS se usa en las siguientes solicitudes de conjunto de OID:

El búfer de propiedades contiene una estructura asociada al miembro PropertyType . El búfer de propiedades sigue la estructura NDIS_SWITCH_PROPERTY_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.

Nota A partir de Windows Server 2012, el miembro PropertyType debe establecerse en NdisSwitchPropertyTypeCustom y el búfer de propiedades debe contener una estructura NDIS_SWITCH_PROPERTY_CUSTOM.

Las extensiones de conmutador extensible pueden acceder al búfer de propiedades de conmutador extensible dentro de una estructura de NDIS_SWITCH_PROPERTY_PARAMETERS mediante la macro NDIS_SWITCH_PROPERTY_PARAMETERS_GET_PROPERTY .

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