Функция PcRegisterPhysicalConnectionFromExternal (portcls.h)

Статья
02/29/2024

Функция PcRegisterPhysicalConnectionFromExternal регистрирует физическое подключение к фильтру аудиоадаптера из фильтра внешнего аудиоадаптера.

Синтаксис

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionFromExternal(
  [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 .

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

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

Драйвер адаптера вызывает PcRegisterPhysicalConnectionFromExternal , чтобы зарегистрировать физическое соединение с системным драйвером PortCls. PortCls хранит эти сведения, чтобы драйвер порта впоследствии использовал эти сведения для ответа на запросы свойств KSPROPERTY_PIN_PHYSICALCONNECTION .

Эта функция полезна для указания связи топологии между двумя аудиоадаптерами, управляемыми разными драйверами адаптера. Функция регистрирует физическое соединение между объектом фильтра, представляющим вложенный объект в локальном звуковом адаптере, и объектом фильтра, представляющим вложенный объект во внешнем адаптере.

Параметр FromString является символьной ссылкой на вложенный объект, предоставляемый драйвером внешнего адаптера.

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

Драйвер адаптера может вызвать метод IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal , чтобы удалить регистрацию физического подключения, зарегистрированного при предыдущем вызове PcRegisterPhysicalConnectionFromExternal. Дополнительные сведения см. в разделе Dynamic Audio Subvices.

Требования

Требование	Значение
Минимальная версия клиента	Драйвер системы PortCls реализует функцию PcRegisterPhysicalConnectionFromExternal в Microsoft Windows 98/Me, а также в операционных системах Windows 2000 и более поздних версий.
Целевая платформа	Универсальное
Верхняя часть	portcls.h (включая Portcls.h)
Библиотека	Portcls.lib
IRQL	PASSIVE_LEVEL