NdisFGetOptionalSwitchHandlers, fonction (ndis.h)

  • Article

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.

Note Avant que l’extension appelle NdisFGetOptionalSwitchHandlers, elle doit initialiser le membre Header de la structure NDIS_SWITCH_OPTIONAL_HANDLERS .
 

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

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS