Función PcRegisterPhysicalConnection (portcls.h)

Artículo
08/07/2023

La función PcRegisterPhysicalConnection registra una conexión física entre dos filtros de adaptador de audio al que se crea una instancia del mismo controlador del adaptador.

Sintaxis

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

Parámetros

[in] DeviceObject

Puntero al objeto de dispositivo para el dispositivo adaptador. Este parámetro debe apuntar a 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] 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 subdispositivo que proporciona el pin (entrada) del receptor de datos de la conexión.

[in] ToPin

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

Valor devuelto

PcRegisterPhysicalConnection 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 PcRegisterPhysicalConnection 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 .

Los parámetros que proporciona el autor de la llamada a la función PcRegisterPhysicalConnection describen una conexión física entre dos subdispositivos (representados como filtros individuales) en la misma tarjeta de adaptador.

A diferencia de una conexión lógica entre dos patillas, que se puede configurar bajo el control de software, una conexión física está cableada. Por ejemplo, una tarjeta de adaptador típica podría tener una conexión física que lleva la señal analógica del pin de salida de su filtro de salida de onda al pin de entrada de su filtro de topología.

Para obtener un ejemplo de la rutina de inicio del dispositivo del controlador del adaptador (consulta Secuencia de inicio) que usa la llamada PcRegisterPhysicalConnection para registrar las conexiones físicas de un adaptador, consulta el código fuente del controlador de audio de ejemplo SB16 en el Kit de controladores de Microsoft Windows (WDK).

Un controlador de adaptador puede llamar al método IUnregisterPhysicalConnection::UnregisterPhysicalConnection para eliminar el registro de una conexión física registrada por una llamada anterior a PcRegisterPhysicalConnection. 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 PcRegisterPhysicalConnection 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