Función NdisFGetOptionalSwitchHandlers (ndis.h)

Las extensiones extensibles de conmutador de Hyper-V llaman a la función NdisFGetOptionalSwitchHandlers para obtener una lista de punteros a las funciones de controlador de conmutador extensible de 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 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 de controlador de conmutador extensible.

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

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.

Comentarios

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

Si la extensión se instala con varias entradas INF FilterMediaTypes , la llamada a NdisFGetOptionalSwitchHandlers permite a la extensión determinar si está enlazada y conectada 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 Requisitos de INF para extensiones de conmutador extensible de Hyper-V.

Requisitos

Consulte también

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS