Partager via


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 :

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