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

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

Требования

См. также

DEVICE_OBJECT

IPort

IUnregisterPhysicalConnection::UnregisterPhysicalConnection

KSPROPERTY_PIN_PHYSICALCONNECTION

PcRegisterPhysicalConnectionFromExternal

PcRegisterPhysicalConnectionToExternal