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_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
Interrogation de la configuration du commutateur extensible Hyper-V