NdisFGetOptionalSwitchHandlers, fonction (ndis.h)

Article
02/07/2025

Hyper-V extensions de commutateur extensible appellent la fonction NdisFGetOptionalSwitchHandlers pour obtenir la liste des pointeurs vers les fonctions de gestionnaire de commutateur extensible 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. Quand NDIS a appelé la fonction FilterAttach de l’extension, elle 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 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 Hyper-V fonctions de gestionnaire de commutateur extensible.

Remarque Avant que l’extension n’appelle NdisFGetOptionalSwitchHandlers, elle doit initialiser le membre 'en-tête de la structure NDIS_SWITCH_OPTIONAL_HANDLERS.

Valeur de retour

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 de sa fonction FilterAttach.

Si l’extension est installée avec plusieurs entrées FilterMediaTypes INF, l’appel à NdisFGetOptionalSwitchHandlers permet à l’extension de déterminer s’il est lié et attaché à 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 des pilotes pour une carte réseau physique.

Pour plus d’informations sur FiltreMediaTypes entrées INF pour les extensions de commutateur extensible, consultez exigences INF pour Hyper-V extensions de commutateur extensible.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.30 et versions ultérieures.
plateforme cible	Universel
d’en-tête	ndis.h (include Ndis.h)
bibliothèque	Ndis.lib
IRQL	<= DISPATCH_LEVEL

Voir aussi

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS

Partager via