structure NDIS_SWITCH_PORT_PROPERTY_CUSTOM (ntddndis.h)

Article
02/07/2025

La structure NDIS_SWITCH_PORT_PROPERTY_CUSTOM spécifie une propriété de stratégie personnalisée pour un port de commutateur extensible Hyper-V.

Les éditeurs de logiciels indépendants définissent le format des propriétés personnalisées. Le format de la propriété personnalisée est propriétaire de l’ISV.

Syntaxe

typedef struct _NDIS_SWITCH_PORT_PROPERTY_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              PropertyBufferLength;
  ULONG              PropertyBufferOffset;
} NDIS_SWITCH_PORT_PROPERTY_CUSTOM, *PNDIS_SWITCH_PORT_PROPERTY_CUSTOM;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_PORT_PROPERTY_CUSTOM. Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER.

Le membre type de l'd’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure de NDIS_SWITCH_PORT_PROPERTY_CUSTOM, le membre Revision de Header doit être défini sur la valeur suivante :

NDIS_SWITCH_PORT_PROPERTY_CUSTOM_REVISION_1

Version d’origine pour NDIS 6.30 et versions ultérieures.

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_CUSTOM_REVISION_1.

Flags

Valeur ULONG qui contient une ou d’indicateurs au niveau du bit. Ce membre est réservé à NDIS.

PropertyBufferLength

Valeur ULONG qui spécifie la taille, en octets, de la mémoire tampon qui contient la propriété de port personnalisée.

PropertyBufferOffset

Valeur ULONG qui spécifie le décalage, en octets, dans la mémoire tampon de propriété. Le décalage est mesuré du début de la structure NDIS_SWITCH_PORT_PROPERTY_CUSTOM jusqu’au début de la mémoire tampon de propriété.

Remarques

La structure NDIS_SWITCH_PORT_PROPERTY_CUSTOM est utilisée dans les requêtes de jeu d’OID suivantes :

La structure NDIS_SWITCH_PORT_PROPERTY_CUSTOM suit la structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS dans la mémoire tampon associée à ces demandes de jeu d’OID. Le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers cette mémoire tampon.

Les extensions de commutateur extensible peuvent accéder à la mémoire tampon de propriété de port personnalisée à l’intérieur d’une structure NDIS_SWITCH_PORT_PROPERTY_CUSTOM à l’aide de la macro NDIS_SWITCH_PORT_PROPERTY_CUSTOM_GET_BUFFER.

Pour plus d’informations sur les stratégies de commutateur extensible, consultez Hyper-V stratégies de commutateur extensible.