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

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

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

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

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

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

Наследство

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

Методика

Интерфейс IUnregisterPhysicalConnection имеет эти методы.

 
IUnregisterPhysicalConnection::UnregisterPhysicalConnection

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

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

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

Требования

Требование Ценность
целевая платформа Виндоус
заголовка portcls.h
  • Last updated on