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

Статья
08/07/2023

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

Синтаксис

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

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

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

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

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

Параметр ToString является символьной ссылкой на подстроку, которая предоставляется драйвером внешнего адаптера.

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

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

Требования

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