Partager via


OID_SWITCH_PARAMETERS

Une extension de commutateur extensible Hyper-V émet une requête d’identificateur d’objet (OID) de OID_SWITCH_PARAMETERS pour obtenir les données de configuration du commutateur extensible.

Si la requête OID se termine correctement, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SWITCH_PARAMETERS .

Notes

Lorsque l’extension traite la structure NDIS_SWITCH_PARAMETERS retournée, elle ne doit pas supposer que les différents membres de chaîne de la structure NDIS_SWITCH_PARAMETERS , tels que SwitchName, 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 . L’extension doit déterminer la longueur de chaîne à partir de la valeur du membre Length de cette structure.

Note Si la chaîne est terminée par 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_PARAMETERS et retourne l’un des codes status suivants.

Code d’état Description

NDIS_STATUS_SUCCESS

La demande 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 OID_SWITCH_PARAMETERS pour une requête de requête OID. Le bord miniport sous-jacent du commutateur extensible définit les DONNÉES. QUERY_INFORMATION. BytesNeeded membre dans la structure NDIS_OID_REQUEST à 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_PARAMETERS

NdisFOidRequest