OID_SWITCH_PORT_PROPERTY_ENUM

Article
03/13/2025

L’extension de commutateur extensible Hyper-V émet une demande de méthode d’identificateur d’objet (OID) de OID_SWITCH_PORT_PROPERTY_ENUM pour obtenir un tableau. Ce tableau contient les stratégies de port approvisionnées qui correspondent aux critères spécifiés. Chaque élément du tableau spécifie les propriétés d’une stratégie pour un port de commutateur extensible spécifié.

Le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une mémoire tampon. Cette mémoire tampon contient les données suivantes :

Structure NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS qui spécifie les paramètres de l’énumération de stratégie d’un port spécifié.
Tableau de structures NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO. Chacune de ces structures contient des informations sur les propriétés d’une stratégie de port de commutateur extensible.

Remarque Si le membre numProperties de la structure NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS est défini sur zéro, aucune structure NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO n’est retournée.

Remarques

Avant de émet une demande de méthode OID de OID_SWITCH_PORT_PROPERTY_ENUM, l’extension de commutateur extensible doit suivre les instructions suivantes :

L’extension ne peut émettre que la demande de OID_SWITCH_PORT_PROPERTY_ENUM après que le bord du protocole du commutateur extensible émet une demande de OID_SWITCH_PORT_CREATE et avant qu’elle émet une demande de OID_SWITCH_PORT_TEARDOWN.
L’extension doit appeler ReferenceSwitchPort avant d’appeler NdisFOidRequest pour émettre la demande de OID_SWITCH_PORT_PROPERTY_ENUM. Cela garantit que le port spécifié ne sera pas supprimé tant que la requête OID n’est pas terminée.

Une fois la requête OID terminée, l’extension doit appeler DereferenceSwitchPort. L’extension doit appeler cette fonction, que la requête OID soit terminée avec NDIS_STATUS_SUCCESS.

L’OID OID_SWITCH_PORT_PROPERTY_ENUM ne doit être émis que lorsque le commutateur extensible Hyper-V a terminé l’activation. Pour plus d’informations, consultez interrogation de la configuration Hyper-V commutateur extensible.

Remarque Si l’extension reçoit la demande de méthode OID de OID_SWITCH_PORT_PROPERTY_ENUM, elle ne doit pas terminer la requête OID. Au lieu de cela, il doit appeler NdisFOidRequest pour transférer la requête OID vers le bas de la pile de pilotes de commutateur extensible.

Codes d’état de retour

Le bord miniport sous-jacent du commutateur extensible termine la requête de requête OID de OID_SWITCH_PORT_PROPERTY_ENUM et retourne le code d’état suivant.