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

Статья
02/26/2024

Метод 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, если вызов был успешным. В противном случае возвращается соответствующий код ошибки.