NdisFGetOptionalSwitchHandlers, fonction (ndis.h)
Les extensions de commutateur extensible Hyper-V appellent la fonction NdisFGetOptionalSwitchHandlers pour obtenir une liste de pointeurs vers les fonctions de gestionnaire de commutateurs extensibles Hyper-V.
Syntaxe
NDIS_STATUS NdisFGetOptionalSwitchHandlers(
[in] NDIS_HANDLE NdisFilterHandle,
[out] PNDIS_SWITCH_CONTEXT NdisSwitchContext,
[in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);
Paramètres
[in] NdisFilterHandle
Handle NDIS qui identifie ce module de filtre. Lorsque NDIS a appelé la fonction FilterAttach de l’extension, il a passé ce handle dans le paramètre NdisFilterHandle .
[out] NdisSwitchContext
Pointeur vers la valeur NDIS_SWITCH_CONTEXT qui identifie le module de commutateur extensible auquel l’extension est attachée. Lorsque l’extension appelle une fonction de gestionnaire de commutateur extensible, elle doit définir le paramètre NdisSwitchContext sur la valeur de ce handle.
[in, out] NdisSwitchHandlers
Pointeur vers une structure de NDIS_SWITCH_OPTIONAL_HANDLERS allouée par l’appelant. Si l’appel réussit, cette structure contient une liste de pointeurs vers les fonctions de gestionnaire de commutateur extensibles.
Pour plus d’informations sur ces fonctions de gestionnaire, consultez Fonctions de gestionnaire de commutateur extensible Hyper-V.
Valeur retournée
Si l’appel réussit, NdisFGetOptionalSwitchHandlers retourne NDIS_STATUS_SUCCESS. Sinon, elle retourne NDIS_STATUS_NOT_SUPPORTED si l’extension de commutateur extensible n’est pas liée au composant de commutateur extensible sous-jacent.
Remarques
L’extension appelle la fonction NdisFGetOptionalSwitchHandlers à partir de sa fonction FilterAttach .
Si l’extension est installée avec plusieurs entrées INF FilterMediaTypes , l’appel à NdisFGetOptionalSwitchHandlers permet à l’extension de déterminer si elle est liée et attachée à la pile des pilotes pour le commutateur extensible ou une carte réseau physique. Si l’appel retourne NDIS_STATUS_SUCCESS, l’extension est attachée dans la pile de pilotes de commutateur extensible. Si l’appel retourne NDIS_STATUS_NOT_SUPPORTED, l’extension est attachée dans la pile de pilotes pour une carte réseau physique.
Pour plus d’informations sur les entrées INF FilterMediaTypes pour les extensions de commutateur extensible, consultez Exigences INF pour les extensions de commutateur extensible Hyper-V.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Pris en charge dans NDIS 6.30 et versions ultérieures. |
Plateforme cible | Universal |
En-tête | ndis.h (inclure Ndis.h) |
Bibliothèque | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
Voir aussi