функция обратного вызова 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 (include Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
См. также