OID_SWITCH_FEATURE_STATUS_QUERY

Article
06/15/2023

Le bord du protocole du commutateur extensible Hyper-V émet une demande de méthode d’identificateur d’objet (OID) de OID_SWITCH_FEATURE_STATUS_QUERY pour obtenir des informations de status personnalisées à partir d’une extension sur le commutateur extensible. Ces informations sont appelées informations sur les fonctionnalités status. Le format de ces informations est défini par le fournisseur de logiciels indépendant (ISV).

Après un retour réussi de cette demande de méthode OID, 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_FEATURE_STATUS_PARAMETERS qui spécifie les paramètres du type de fonctionnalité status informations à retourner.
Structure NDIS_SWITCH_FEATURE_STATUS_CUSTOM qui contient la fonctionnalité status informations pour le commutateur extensible.

Notes

Pour obtenir des instructions sur la façon de gérer une demande d’ensemble OID de OID_SWITCH_FEATURE_STATUS_QUERY, consultez Gestion des informations d’état de fonctionnalité de commutateur personnalisé.

Codes d’état de retour

L’extension retourne l’un des codes status suivants pour la demande de méthode OID de OID_SWITCH_FEATURE_STATUS_QUERY.

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 fonctionnalité status informations ainsi que les structures NDIS_SWITCH_FEATURE_STATUS_CUSTOM et NDIS_SWITCH_FEATURE_STATUS_PARAMETERS. Le bord miniport sous-jacent du commutateur extensible définit les DONNÉES. METHOD_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_PROPERTY_TYPE

NDIS_SWITCH_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS