Función PcRegisterPhysicalConnectionFromExternal (portcls.h)

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

   
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
Header portcls.h (incluya Portcls.h)
Library Portcls.lib
IRQL PASSIVE_LEVEL

Consulte también

DEVICE_OBJECT

IPort

IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal

KSPROPERTY_PIN_PHYSICALCONNECTION

PcRegisterPhysicalConnection

PcRegisterPhysicalConnectionToExternal