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

Функция 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. Дополнительные сведения см. в динамических аудиоподделий.

Требования

См. также

DEVICE_OBJECT

IPort

IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal

KSPROPERTY_PIN_PHYSICALCONNECTION

PcRegisterPhysicalConnection

PcRegisterPhysicalConnectionToExternal