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

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

Синтаксис

NDIS_SWITCH_DEREFERENCE_SWITCH_NIC NdisSwitchDereferenceSwitchNic;

NDIS_STATUS NdisSwitchDereferenceSwitchNic(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId,
  [in] NDIS_SWITCH_NIC_INDEX SwitchNicIndex
)
{...}

Параметры

[in] NdisSwitchContext

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

[in] SwitchPortId

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

[in] SwitchNicIndex

Значение NDIS_SWITCH_NIC_INDEX, указывающее индекс виртуального сетевого адаптера, для которого добавится расширяемый счетчик ссылок коммутатора.

Дополнительные сведения о значениях NDIS_SWITCH_NIC_INDEX см. в значения индекса сетевого адаптера.

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

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

Замечания

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

Расширение должно вызывать DereferenceSwitchNic, если он ранее вызывал ReferenceSwitchNic для подключения к сетевому адаптеру.

Требования

См. также

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic