Función PcRegisterPhysicalConnectionFromExternal (portcls.h)

Artículo
08/07/2023

La función PcRegisterPhysicalConnectionFromExternal registra una conexión física a un filtro de adaptador de audio desde un filtro de adaptador de audio externo.

Sintaxis

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionFromExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNICODE_STRING FromString,
  [in] ULONG           FromPin,
  [in] PUNKNOWN        ToUnknown,
  [in] ULONG           ToPin
);

Parámetros

[in] DeviceObject

Puntero al objeto de dispositivo para el dispositivo. Se trata de una estructura del sistema de tipo DEVICE_OBJECT.

[in] FromString

Puntero a una cadena Unicode terminada en null que contiene el nombre de vínculo simbólico del filtro externo que proporciona el pin de origen de la conexión.

[in] FromPin

Especifica un identificador de patilla. Este parámetro identifica el pin de origen (salida) en el filtro externo denominado por FromString.

[in] ToUnknown

Puntero a la interfaz IPort de un objeto de controlador de puerto. El objeto del controlador de puerto asociado a ToUnknown está enlazado al subdevice que proporciona el receptor de datos (entrada) de la conexión.

[in] ToPin

Especifica un identificador de patilla. Este parámetro identifica el anclaje del receptor (entrada) en el filtro asociado a la interfaz ToUnknown .

Valor devuelto

PcRegisterPhysicalConnectionFromExternal devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.

Comentarios

Un controlador de adaptador llama a PcRegisterPhysicalConnectionFromExternal para registrar una conexión física con el controlador del sistema PortCls. PortCls almacena esta información para que el controlador de puerto pueda usar posteriormente la información para responder a KSPROPERTY_PIN_PHYSICALCONNECTION solicitudes de propiedad.

Esta función es útil para especificar un vínculo de topología entre dos adaptadores de audio controlados por distintos controladores de adaptador. La función registra una conexión física entre un objeto de filtro que representa un subdispositivo en el adaptador de audio local y un objeto de filtro que representa un subdispositivo en un adaptador externo.

El parámetro FromString es un vínculo simbólico al subdispositivo expuesto por el controlador del adaptador externo.

La información necesaria para registrar una conexión física externa debe proporcionarse a los dos controladores. Esto se puede hacer durante una instalación coordinada inicial de los dos dispositivos, o se puede realizar dinámicamente mediante un programa de configuración en modo de usuario que coordina los cambios en las configuraciones de ambos dispositivos.

Un controlador de adaptador puede llamar al método IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal para eliminar el registro de una conexión física registrada por una llamada anterior a PcRegisterPhysicalConnectionFromExternal. Para obtener más información, vea Subdevices de audio dinámico.

Requisitos

Requisito	Value
Cliente mínimo compatible	El controlador del sistema PortCls implementa la función PcRegisterPhysicalConnectionFromExternal en Microsoft Windows 98/Me y en los sistemas operativos Windows 2000 y versiones posteriores.
Plataforma de destino	Universal
Encabezado	portcls.h (incluya Portcls.h)
Library	Portcls.lib
IRQL	PASSIVE_LEVEL