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

Статья
08/07/2023

Функция PcRegisterPhysicalConnection регистрирует физическое соединение между двумя фильтрами аудиоадаптеров, экземплярами которых является один и тот же драйвер адаптера.

Синтаксис

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnection(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PUNKNOWN       FromUnknown,
  [in] ULONG          FromPin,
  [in] PUNKNOWN       ToUnknown,
  [in] ULONG          ToPin
);

Параметры

[in] DeviceObject

Указатель на объект устройства адаптера. Этот параметр должен указывать на системную структуру типа DEVICE_OBJECT.

[in] FromUnknown

Указатель на интерфейс IPort объекта драйвера порта. Объект драйвера порта, связанный с FromUnknown , привязывается к дочерней части, которая предоставляет контакт источника данных (выходных данных) подключения.

[in] FromPin

Указывает идентификатор закрепления. Этот параметр идентифицирует исходный (выходной) закрепление на фильтре, связанном с интерфейсом FromUnknown .

[in] ToUnknown

Указатель на интерфейс IPort объекта драйвера порта. Объект драйвера порта, связанный с ToUnknown , привязывается к подсети, которая предоставляет контакт приемника данных (входных данных) подключения.

[in] ToPin

Указывает идентификатор закрепления. Этот параметр идентифицирует контакт приемника (входных данных) на фильтре, связанном с интерфейсом ToUnknown .

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

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

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

Параметры, которые вызывающий объект предоставляет функции PcRegisterPhysicalConnection, описывают физическое соединение между двумя вложенными устройствами (представленными в виде отдельных фильтров) на одном адаптере карта.

В отличие от логического соединения между двумя контактами, которое можно настроить под управлением программного обеспечения, физическое соединение является жестким. Например, типичный адаптер карта может иметь физическое соединение, которое передает аналоговый сигнал от выходного контакта фильтра волнового вывода к входному контакту своего фильтра топологии.

Пример процедуры запуска устройства драйвера адаптера (см. последовательность запуска), которая использует вызов PcRegisterPhysicalConnection для регистрации физических подключений адаптера, см. в исходном коде примера аудиодрайвера SB16 в комплекте драйверов Microsoft Windows (WDK).

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

Требования

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