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

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

Требования

См. также

DEVICE_OBJECT

IPort

IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal

KSPROPERTY_PIN_PHYSICALCONNECTION

PcRegisterPhysicalConnection

PcRegisterPhysicalConnectionFromExternal