Метод IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal (portcls.h)

Статья
02/07/2025

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

Синтаксис

NTSTATUS UnregisterPhysicalConnectionFromExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNICODE_STRING FromString,
  [in] ULONG           FromPin,
  [in] PUNKNOWN        ToUnknown,
  [in] ULONG           ToPin
);

Параметры

[in] DeviceObject

Указатель на объект устройства для адаптера. Этот параметр должен указывать на системную структуру типа DEVICE_OBJECT.

[in] FromString

Указатель на строку Юникода, завершающую значение NULL, которая содержит имя внешнего фильтра, который предоставляет пин-код источника данных подключения.

[in] FromPin

Указывает идентификатор пин-кода. Этот параметр определяет пин-код источника данных (выходных данных) во внешнем фильтре, который называется параметром FromString.

[in] ToUnknown

Указатель на интерфейс IPort объекта драйвера портов. Объект драйвера порта, связанный с ToUnknown, привязан к подчиненной части, которая предоставляет пин-код приемника данных подключения.

[in] ToPin

Указывает идентификатор пин-кода. Этот параметр определяет пин-код приемника данных (входных данных) фильтра, связанного с интерфейсом ToUnknown.

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

UnregisterPhysicalConnectionFromExternal возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки.