Gestion des informations d’état des fonctionnalités de port personnalisées
L’interface de commutateur extensible Hyper-V utilise l’identificateur d’objet (OID) suivant pour interroger des informations de status personnalisées pour un port de commutateur extensible. Ces informations status sont appelées informations sur la fonctionnalité de port status :
OID_SWITCH_PORT_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 port 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_PORT_FEATURE_STATUS_PARAMETERS qui spécifie la fonctionnalité personnalisée status informations à retourner.
Note Pour un status de fonctionnalité personnalisé, le membre FeatureStatusType est défini sur NdisSwitchPortPropertyTypeCustom.
Structure NDIS_SWITCH_PORT_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_PORT_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 fonctionnalité.
L’extension de commutateur extensible doit suivre ces instructions lorsqu’elle reçoit une demande de méthode OID de OID_SWITCH_PORT_FEATURE_STATUS_QUERY :
L’extension doit gérer la requête OID si elle gère une propriété de port de commutateur extensible personnalisée qui correspond au membre FeatureStatusId de la structure NDIS_SWITCH_PORT_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_PORT_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 propriété de commutateur extensible personnalisée, 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 de la fonctionnalité de port status informations, consultez État de la fonctionnalité de port personnalisé.