Gestion des informations d’état des fonctionnalités de commutateur personnalisé
L’interface de commutateur extensible Hyper-V utilise l’identificateur d’objet (OID) suivant pour interroger des informations de status personnalisées pour le commutateur extensible. Ces informations status sont appelées informations de status de fonctionnalité de basculement :
OID_SWITCH_FEATURE_STATUS_QUERY
Cette demande de méthode OID est émise par le bord du protocole du commutateur extensible pour obtenir la fonctionnalité personnalisée status informations pour une propriété de commutateur spécifiée.
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 la fonctionnalité personnalisée status informations à retourner.
Note Pour une fonctionnalité personnalisée status, le membre FeatureStatusType est défini sur NdisSwitchPropertyTypeCustom.
Structure NDIS_SWITCH_FEATURE_STATUS_CUSTOM qui contient les informations status sur une propriété personnalisée affectée à un port de commutateur extensible.
Lorsque le bord du protocole du commutateur extensible émet la requête OID_SWITCH_FEATURE_STATUS_QUERY, il définit les membres FeatureStatusCustomBufferLength et FeatureStatusCustomBufferOffset à un emplacement dans le membre InformationBuffer que l’extension peut utiliser pour renvoyer les informations de status de fonctionnalité.
L’extension de commutateur extensible doit suivre ces instructions lorsqu’elle reçoit une demande de méthode OID de OID_SWITCH_FEATURE_STATUS_QUERY :
L’extension doit gérer la requête OID si elle gère une fonctionnalité de commutateur extensible personnalisée status qui correspond au membre FeatureStatusId de la structure NDIS_SWITCH_FEATURE_STATUS_PARAMETERS.
Si l’extension gère la demande de méthode OID, elle doit retourner la fonctionnalité status informations qui correspondent aux paramètres spécifiés par la structure NDIS_SWITCH_FEATURE_STATUS_PARAMETERS.
Si la fonctionnalité status mémoire tampon est trop petite, l’extension doit échouer la requête OID avec NDIS_STATUS_INVALID_LENGTH. L’extension doit définir les données. SET_INFORMATION. BytesNeeded membre dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
Sinon, l’extension doit retourner la fonctionnalité status informations et terminer la demande OID avec NDIS_STATUS_SUCCESS.
Si l’extension ne gère pas la fonctionnalité de commutateur extensible personnalisée status, elle doit appeler NdisFOidRequest pour transférer la requête OID vers le bas de la pile de pilotes de commutateur extensible.
Pour plus d’informations sur le transfert de requêtes OID, consultez Filtrage des requêtes OID dans un pilote de filtre NDIS.
Pour plus d’informations sur la définition et l’inscription des status de fonctionnalité de commutateur, consultez État de la fonctionnalité de commutateur personnalisé.