Compartir a través de


Función NdisFGetOptionalSwitchHandlers (ndis.h)

Hyper-V extensiones de conmutador extensible llaman a la función NdisFGetOptionalSwitchHandlers para obtener una lista de punteros a las funciones del controlador de conmutador extensible Hyper-V.

Sintaxis

NDIS_STATUS NdisFGetOptionalSwitchHandlers(
  [in]      NDIS_HANDLE                    NdisFilterHandle,
  [out]     PNDIS_SWITCH_CONTEXT           NdisSwitchContext,
  [in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);

Parámetros

[in] NdisFilterHandle

Identificador NDIS que identifica este módulo de filtro. Cuando NDIS llamó a la función FilterAttach de la extensión, pasó este identificador en el parámetro NdisFilterHandle.

[out] NdisSwitchContext

Puntero al valor de NDIS_SWITCH_CONTEXT que identifica el módulo de conmutador extensible al que está asociada la extensión. Cuando la extensión llama a una función de controlador de conmutador extensible, debe establecer el parámetro NdisSwitchContext en el valor de este identificador.

[in, out] NdisSwitchHandlers

Puntero a una estructura de NDIS_SWITCH_OPTIONAL_HANDLERS asignada por el autor de la llamada. Si la llamada se realiza correctamente, esta estructura contendrá una lista de punteros a las funciones del controlador de conmutador extensible.

Para obtener más información sobre estas funciones de controlador, vea Hyper-V funciones de controlador de conmutador extensible.

Nota Antes de que la extensión llame a NdisFGetOptionalSwitchHandlers, debe inicializar el miembro Header de la estructura NDIS_SWITCH_OPTIONAL_HANDLERS.
 

Valor devuelto

Si la llamada se realiza correctamente, NdisFGetOptionalSwitchHandlers devuelve NDIS_STATUS_SUCCESS. De lo contrario, devuelve NDIS_STATUS_NOT_SUPPORTED si la extensión de conmutador extensible no está enlazada al componente de conmutador extensible subyacente.

Observaciones

La extensión llama a la función NdisFGetOptionalSwitchHandlers desde su función FilterAttach.

Si la extensión se instala con varias entradas de FilterMediaTypes INF, la llamada a NdisFGetOptionalSwitchHandlers permite a la extensión determinar si está enlazado y conectado a la pila de controladores para el conmutador extensible o un adaptador de red físico. Si la llamada devuelve NDIS_STATUS_SUCCESS, la extensión se adjunta dentro de la pila de controladores de conmutador extensible. Si la llamada devuelve NDIS_STATUS_NOT_SUPPORTED, la extensión se adjunta dentro de la pila de controladores para un adaptador de red físico.

Para obtener más información sobre las entradas inf de FilterMediaTypes para extensiones de conmutador extensible, vea INF Requirements for Hyper-V Extensible Switch Extensions.

Requisitos

Requisito Valor
cliente mínimo admitido Compatible con NDIS 6.30 y versiones posteriores.
de la plataforma de destino de Universal
encabezado de ndis.h (incluya Ndis.h)
biblioteca de Ndis.lib
irQL <= DISPATCH_LEVEL

Consulte también

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS