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

Статья
02/07/2025

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

Синтаксис

NTSTATUS UnregisterPhysicalConnectionToExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNKNOWN        FromUnknown,
  [in] ULONG           FromPin,
  [in] PUNICODE_STRING ToString,
  [in] ULONG           ToPin
);

Параметры

[in] DeviceObject

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

[in] FromUnknown

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

[in] FromPin

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

[in] ToString

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

[in] ToPin

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

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

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