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.
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