Partager via


OID_SWITCH_PORT_ARRAY

Une extension de commutateur extensible Hyper-V émet une 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 OID se termine correctement, 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_PORT_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 gère la structure NDIS_SWITCH_PORT_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 PortName, sont terminés par une valeur 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 OID de OID_SWITCH_PORT_ARRAY et retourne l’un des codes 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_PORT_ARRAY et son tableau d’éléments NDIS_SWITCH_PORT_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


NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

Interrogation de la configuration du commutateur extensible Hyper-V