estructura NDIS_SWITCH_PORT_PROPERTY_PROFILE (ntddndis.h)

Artículo
02/26/2024

La estructura NDIS_SWITCH_PORT_PROPERTY_PROFILE especifica una propiedad de directiva para un puerto de conmutador extensible de Hyper-V que la extensión de conmutador extensible guarda en su propio almacén de directivas en lugar de en el almacén de directivas de Hyper-V. En este caso, las definiciones de directiva se identifican mediante perfiles de propiedad dentro del almacén de directivas del controlador.

Sintaxis

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PROFILE {
  NDIS_OBJECT_HEADER                          Header;
  ULONG                                       Flags;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME      ProfileName;
  GUID                                        ProfileId;
  NDIS_VENDOR_NAME                            VendorName;
  GUID                                        VendorId;
  UINT32                                      ProfileData;
  GUID                                        NetCfgInstanceId;
  struct {
    UINT32 PciSegmentNumber : 16;
    UINT32 PciBusNumber : 8;
    UINT32 PciDeviceNumber : 5;
    UINT32 PciFunctionNumber : 3;
  } PciLocation;
  UINT32                                      CdnLabelId;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL CdnLabel;
} NDIS_SWITCH_PORT_PROPERTY_PROFILE, *PNDIS_SWITCH_PORT_PROPERTY_PROFILE;

Miembros

Header

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

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1.

Flags

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

ProfileName

Valor de NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME que especifica el nombre descriptivo de la propiedad de perfil.

ProfileId

Valor GUID que identifica de forma única la propiedad de perfil.

VendorName

Valor de NDIS_VENDOR_NAME que especifica el nombre descriptivo del proveedor que definió el perfil de puerto.

VendorId

Valor GUID que identifica al proveedor que definió el perfil de puerto.

ProfileData

NetCfgInstanceId

Valor GUID que especifica el valor del Registro NetCfgInstanceId de la conexión de adaptador de red subyacente para la que se aplica la propiedad.

El valor NetCfgInstanceId se especifica para la conexión del adaptador de red a través de una solicitud de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_CREATE.

PciLocation

Estructura que especifica la ubicación PCI del adaptador de red físico subyacente especificado por el miembro NetCfgInstanceId .

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

PciLocation.PciSegmentNumber

Valor que especifica el grupo de buses PCI en los que está conectado el adaptador de red físico.

PciLocation.PciBusNumber

Valor que especifica el número de bus PCI actual en el que está conectado el adaptador de red físico.

PciLocation.PciDeviceNumber

Valor que especifica el número de dispositivo para el adaptador de red físico en el bus PCI.

Nota El número de dispositivo PCI también se conoce como número de ranura PCI.

PciLocation.PciFunctionNumber

Valor que especifica el número de función de un dispositivo lógico en el adaptador de red físico.

CdnLabelId

Valor UINT32 que especifica un identificador único para los datos contenidos en el miembro CdnLabel .

CdnLabel

Valor de NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL que especifica la etiqueta de RED CDN PCI Express (PCIe) para la ubicación del adaptador de red físico. Una etiqueta cdn proporciona ubicaciones de dispositivos coherentes en ubicaciones de hardware similares.

Comentarios

La extensión usa la estructura NDIS_SWITCH_PORT_PROPERTY_PROFILE para hacer referencia a una propiedad de directiva dentro de un almacén de directivas privado en lugar del almacén de directivas de Hyper-V. Esto permite al proveedor de software independiente (ISV) rellenar y administrar este almacén de directivas privadas a través de canales e interfaces privados. Los proveedores pueden distinguir sus perfiles de los perfiles de otros proveedores mediante los campos VendorName y VendorId .

Nota Las propiedades de directiva de puerto especificadas por una estructura de NDIS_SWITCH_PORT_PROPERTY_PROFILE son transparentes para la interfaz de conmutador extensible.

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

La estructura de NDIS_SWITCH_PORT_PROPERTY_PROFILE sigue la estructura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS en el búfer asociado a estas solicitudes de conjunto de OID. El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a este búfer.

Nota Los tipos de datos NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME y NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL se definen mediante la estructura de IF_COUNTED_STRING . Una cadena definida por esta estructura no tiene que terminar en null. Sin embargo, la longitud de la cadena debe establecerse en el miembro Length de esta estructura. Si la cadena termina en null, el miembro Length no debe incluir el carácter nulo de terminación.

Los miembros PciLocation y CdnLabel solo son relevantes si el perfil de propiedad especifica una directiva para un adaptador de red físico subyacente que está conectado al adaptador de red externo del conmutador extensible. Por ejemplo, si el adaptador de red externo está enlazado a un equipo de adaptadores de conmutador extensible, estos miembros podrían especificar directivas para un único adaptador de ese equipo. Para obtener más información sobre el equipo de conmutadores extensibles, vea Tipos de configuraciones de adaptadores de red físicos.