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

Статья
02/29/2024

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