OID_SWITCH_NIC_ARRAY
Une extension de commutateur extensible Hyper-V émet une requête d’identificateur d’objet (OID) de OID_SWITCH_NIC_ARRAY pour obtenir un tableau. Chaque élément du tableau spécifie les paramètres de configuration d’une carte réseau virtuelle associée à un port de commutateur extensible.
Si la requête OID est correctement effectuée, 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_NIC_ARRAY qui définit le nombre d’éléments dans le tableau. Cette structure spécifie également le décalage vers le premier élément du tableau.
Tableau de structures NDIS_SWITCH_NIC_PARAMETERS . Chacune de ces structures contient des informations sur une carte réseau connectée à un port de commutateur extensible.
Note Si aucune carte réseau n’est connectée à des ports de commutateur extensibles, le bord miniport sous-jacent du commutateur extensible définit le membre NumElements de la structure NDIS_SWITCH_NIC_ARRAY sur zéro. Dans ce cas, aucune structure NDIS_SWITCH_NIC_PARAMETERS n’est retournée.
Notes
L’OID OID_SWITCH_NIC_ARRAY 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 .
Lorsque l’extension traite la structure NDIS_SWITCH_NIC_PARAMETERS retournée, elle ne doit pas supposer que les différents membres de chaîne de la structure NDIS_SWITCH_PORT_PARAMETERS , tels que NicFriendlyName, sont terminés par null. Les types de données de ces membres de chaîne sont définis par la structure IF_COUNTED_STRING . Le pilote doit déterminer la longueur de chaîne à partir de la valeur du membre Length de cette structure.
Note Si la chaîne se termine par un caractère Null, le membre Length ne doit pas inclure le caractère null de fin.
Codes d’état de retour
Le bord miniport sous-jacent du commutateur extensible termine la requête de requête OID de OID_SWITCH_NIC_ARRAY 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 le NDIS_SWITCH_NIC_ARRAY et son tableau d’éléments NDIS_SWITCH_NIC_PARAMETERS . Le bord miniport sous-jacent du commutateur extensible définit les DONNÉES. QUERY_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
Interrogation de la configuration du commutateur extensible Hyper-V