OID_SWITCH_PROPERTY_ENUM

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

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 :

• Structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS qui spécifie les paramètres de l’énumération de stratégie de commutateur extensible.

• Tableau de structures NDIS_SWITCH_PROPERTY_ENUM_INFO . Chacune de ces structures contient des informations sur une stratégie de commutateur extensible.

  Note Si l’extension n’a pas été provisionnée avec des instances de la stratégie de commutateur extensible spécifiée, l’extension définit le membre NumProperties de la structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS sur zéro et aucune structure NDIS_SWITCH_PROPERTY_ENUM_INFO n’est retournée.

Notes

L’OID OID_SWITCH_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 .

Contrairement aux requêtes de requête OID de OID_SWITCH_PORT_PROPERTY_ENUM, l’extension n’a pas besoin d’appeler des fonctions ReferenceSwitchXxx ou DereferenceSwitchXxx lorsqu’elle émet la requête OID_SWITCH_PROPERTY_ENUM dans la pile du pilote de commutateur extensible.

Note Si l’extension reçoit la demande de méthode OID de OID_SWITCH_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 du pilote 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_PROPERTY_ENUM et retourne l’un des codes de status suivants.

Code d’état	Description
NDIS_STATUS_SUCCESS	La requête OID s’est terminée avec succès.
NDIS_STATUS_INVALID_LENGTH	La longueur de la mémoire tampon d’informations est trop petite pour renvoyer la structure NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS et son tableau d’éléments NDIS_SWITCH_PROPERTY_ENUM_INFO . Le bord miniport sous-jacent du commutateur extensible définit les DONNÉES. METHOD_INFORMATION. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE	La demande a échoué pour d’autres raisons.

Spécifications

Version	Pris en charge dans NDIS 6.30 et versions ultérieures.
En-tête	Ntddndis.h (inclure Ndis.h)

Voir aussi

---

NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_ENUM_INFO

NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS

Interrogation de la configuration du commutateur extensible Hyper-V