Función PcRegisterPhysicalConnectionToExternal (portcls.h)

Artículo
02/29/2024

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

Sintaxis

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionToExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNKNOWN        FromUnknown,
  [in] ULONG           FromPin,
  [in] PUNICODE_STRING ToString,
  [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] FromUnknown

Puntero a la interfaz IPort de un objeto de controlador de puerto. El objeto de controlador de puerto asociado a FromUnknown está enlazado al subdispositivo que proporciona el pin (salida) del origen de datos de la conexión.

[in] FromPin

Especifica un identificador de patilla. Este parámetro identifica el pin de origen (salida) en el filtro asociado a la interfaz FromUnknown .

[in] ToString

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

[in] ToPin

Especifica un identificador de patilla. Este parámetro identifica la patilla del receptor (entrada) en el filtro externo denominado por ToString.

Valor devuelto

PcRegisterPhysicalConnectionToExternal 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 PcRegisterPhysicalConnectionToExternal 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 las solicitudes de propiedad KSPROPERTY_PIN_PHYSICALCONNECTION .

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 ToString es un vínculo simbólico al subdispositivo que expone 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 dinámicamente mediante un programa de configuración en modo de usuario que coordina los cambios en la configuración de ambos dispositivos.

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

Requisitos

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