Интерфейс IUnregisterPhysicalConnection (portcls.h)

  • Статья

Интерфейс IUnregisterPhysicalConnection реализует три метода удаления зарегистрированного физического подключения. Драйвер порта реализует этот интерфейс. Чтобы определить, поддерживает IUnregisterPhysicalConnection ли драйвер порта интерфейс, драйвер мини-порта вызывает метод QueryInterface объекта драйвера порта с IID_IUnregisterPhysicalConnection REFIID. Драйвер мини-порта отвечает за освобождение IUnregisterPhysicalConnection объекта после того, как он больше не нужен. Интерфейс IUnregisterPhysicalConnection наследуется от IUnknown.

Интерфейс поддерживают IUnregisterSubdevice следующие драйверы портов:

  • Волновая циклическая
  • WavePci
  • Топология
  • DMus
  • MIDI
Три метода в этом интерфейсе "отменяют регистрацию" физических подключений, которые были зарегистрированы ранее с помощью вызовов процедур PcRegisterPhysicalConnection, PcRegisterPhysicalConnectionFromExternal или PcRegisterPhysicalConnectionToExternal . PortCls поддерживает три подпрограммы PcRegisterPhysicalConnectionXxx .

Драйвер порта использует сведения, полученные из вызовов PcRegisterPhysicalConnectionXxx , для ответа на запросы свойств KSPROPERTY_PIN_PHYSICALCONNECTION .

При удалении подчиненного устройства из топологии адаптера драйвер должен отменить регистрацию физических подключений подсети к этой части топологии. Сбой при отмене регистрации физических подключений подчиненного устройства может привести к утечке памяти.

Наследование

Интерфейс IUnregisterPhysicalConnection наследуется от интерфейса IUnknown . IUnregisterPhysicalConnection также имеет следующие типы членов:

Методы

Интерфейс IUnregisterPhysicalConnection содержит следующие методы.

 
IUnregisterPhysicalConnection::UnregisterPhysicalConnection

Метод UnregisterPhysicalConnection удаляет регистрацию физического подключения, которое было зарегистрировано при предыдущем вызове PcRegisterPhysicalConnection.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal

Метод UnregisterPhysicalConnectionFromExternal удаляет регистрацию физического подключения, которое было зарегистрировано при предыдущем вызове PcRegisterPhysicalConnectionFromExternal.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal

Метод UnregisterPhysicalConnectionToExternal удаляет регистрацию физического подключения, которое было зарегистрировано при предыдущем вызове PcRegisterPhysicalConnectionToExternal.

Требования

Требование Значение
Целевая платформа Windows
Header portcls.h