Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Une extension de commutateur extensible Hyper-V émet une demande de requête d’identificateur d’objet (OID) de OID_SWITCH_PORT_ARRAY pour obtenir un tableau. Chaque élément du tableau spécifie les paramètres de configuration d’un port de commutateur extensible.
Si la requête de requête OID se termine correctement, le InformationBuffer membre 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_PORT_ARRAY qui définit le nombre d’éléments dans le tableau.
Tableau de structures NDIS_SWITCH_PORT_PARAMETERS. Chacune de ces structures contient des informations sur un port sur le commutateur extensible.
Remarque Si aucun port n’a été créé sur le commutateur extensible, le pilote définit les NombreElements membre de la structure NDIS_SWITCH_PORT_ARRAY sur zéro et aucune structure NDIS_SWITCH_PORT_PARAMETERS n’est retournée.
Remarques
L’OID OID_SWITCH_PORT_ARRAY ne doit être émis que lorsque le commutateur extensible Hyper-V a terminé l’activation. Pour plus d’informations, consultez interrogation de la configuration Hyper-V commutateur extensible.
Lorsque l’extension gère la structure de NDIS_SWITCH_PORT_PARAMETERS retournée, il ne doit pas supposer que les différents membres de chaîne de la structure NDIS_SWITCH_PORT_PARAMETERS, tels que nom de port, sont arrêté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 de la valeur de la Length membre de cette structure.
Remarque Si la chaîne est terminée par une valeur 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_PORT_ARRAY et retourne l’un des codes d’état 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_PORT_ARRAY et son tableau d’éléments NDIS_SWITCH_PORT_PARAMETERS. Le bord miniport sous-jacent du commutateur extensible définit la DATA. QUERY_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Exigences
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |
Voir aussi
interroger la configuration de commutateur extensible Hyper-V