функция обратного вызова NDIS_SWITCH_DEREFERENCE_SWITCH_PORT (ndis.h)

  • Статья

Функция DereferenceSwitchPort уменьшает счетчик ссылок расширяемого коммутатора Hyper-V для порта расширяемого коммутатора. Счетчик ссылок был увеличен с помощью предыдущего вызова ReferenceSwitchPort.

Синтаксис

NDIS_SWITCH_DEREFERENCE_SWITCH_PORT NdisSwitchDereferenceSwitchPort;

NDIS_STATUS NdisSwitchDereferenceSwitchPort(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId
)
{...}

Параметры

[in] NdisSwitchContext

Значение NDIS_SWITCH_CONTEXT, содержащее дескриптор модуля расширяемого коммутатора, к которому подключено расширение расширяемого коммутатора Hyper-V. Когда расширение вызывает NdisFGetOptionalSwitchHandlers, этот дескриптор возвращается с помощью параметра NdisSwitchContext .

[in] SwitchPortId

Значение NDIS_SWITCH_PORT_ID, содержащее уникальный идентификатор порта расширяемого коммутатора, для которого увеличивается счетчик ссылок расширяемого коммутатора.

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

Если вызов завершается успешно, функция возвращает NDIS_STATUS_SUCCESS. В противном случае возвращается код ошибки NDIS_STATUS_Xxx, определенный в Ndis.h.

Комментарии

Расширение расширяемого коммутатора вызывает DereferenceSwitchPort для уменьшения счетчика ссылок для порта расширяемого коммутатора. Хотя счетчик ссылок расширяемого коммутатора имеет ненулевое значение, край протокола расширяемого коммутатора не будет выдавать запрос на набор идентификатора объекта (OID) OID_SWITCH_PORT_DELETE для удаления порта.

Расширение должно вызывать DereferenceSwitchPort , если оно ранее вызывало ReferenceSwitchPort для порта расширяемого коммутатора.

Требования

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

См. также раздел

NdisFGetOptionalSwitchHandlers

OID_SWITCH_PORT_DELETE

ReferenceSwitchPort