OID_SWITCH_PORT_PROPERTY_ENUM

Article
06/15/2023

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 membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une mémoire tampon. Cette mémoire tampon contient les données suivantes :

Une 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.

Note 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.

Notes

Avant d’effectuer une demande de méthode OID de OID_SWITCH_PORT_PROPERTY_ENUM, l’extension de commutateur extensible doit suivre ces instructions :

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

Une fois la demande OID terminée, l’extension doit appeler DereferenceSwitchPort. L’extension doit appeler cette fonction, que la demande OID ait ou non été effectuée avec NDIS_STATUS_SUCCESS.

L’OID OID_SWITCH_PORT_PROPERTY_ENUM ne doit être émis qu’une fois l’activation du commutateur extensible Hyper-V terminée. Pour plus d’informations, consultez Interrogation de la configuration du commutateur extensible Hyper-V .

Note Si l’extension reçoit la demande de méthode OID de OID_SWITCH_PORT_PROPERTY_ENUM, elle ne doit pas terminer la demande 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.