Функция NdisFGetOptionalSwitchHandlers (ndis.h)

Статья
02/07/2025

Hyper-V расширения расширяемого коммутатора вызывают функцию NdisFGetOptionalSwitchHandlers для получения списка указателей на функции обработчика расширяемого коммутатора Hyper-V.

Синтаксис

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

Параметры

[in] NdisFilterHandle

Дескриптор NDIS, определяющий этот модуль фильтра. Когда NDIS назвал функцию FilterAtt ach расширения, она передала этот дескриптор в параметре NdisFilterHandle.

[out] NdisSwitchContext

Указатель на значение NDIS_SWITCH_CONTEXT, определяющее расширяемый модуль коммутатора, к которому подключено расширение. Когда расширение вызывает функцию обработчика расширяемого коммутатора, оно должно задать параметр NdisSwitchContext значением этого дескриптора.

[in, out] NdisSwitchHandlers

Указатель на структуру, выделенную вызывающим объектом NDIS_SWITCH_OPTIONAL_HANDLERS. Если вызов выполнен успешно, эта структура будет содержать список указателей на функции обработчика расширяемого коммутатора.

Дополнительные сведения об этих функциях обработчика см. в Hyper-V расширенных функций обработчика коммутаторов.

Примечание перед вызовом расширения NdisFGetOptionalSwitchHandlers, он должен инициализировать заголовка члена структуры NDIS_SWITCH_OPTIONAL_HANDLERS.

Возвращаемое значение

Если вызов выполнен успешно, NdisFGetOptionalSwitchHandlers возвращает NDIS_STATUS_SUCCESS. В противном случае возвращается NDIS_STATUS_NOT_SUPPORTED, если расширение расширяемого коммутатора не привязано к базовому компоненту расширяемого коммутатора.

Замечания

Расширение вызывает функцию NdisFGetOptionalSwitchHandler s из функции FilterAttach.

Если расширение установлено с несколькими записями FilterMediaTypes INF, вызов NdisFGetOptionalSwitchHandlers позволяет расширению определить, привязано ли оно к стеку драйверов для расширяемого коммутатора или физического сетевого адаптера. Если вызов возвращает NDIS_STATUS_SUCCESS, расширение присоединяется в расширяемом стеке драйверов коммутатора. Если вызов возвращает NDIS_STATUS_NOT_SUPPORTED, расширение подключено в стеке драйверов для физического сетевого адаптера.

Дополнительные сведения о записях FilterMediaTypes INF для расширений расширяемых коммутаторов см. в разделе ТРЕБОВАНИЯ INF для расширений Hyper-V расширяемого коммутатора.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.30 и более поздних версиях.
целевая платформа	Всеобщий
заголовка	ndis.h (include Ndis.h)
библиотеки	Ndis.lib
IRQL	<= DISPATCH_LEVEL

См. также

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS

Поделиться через