Función PcRegisterPhysicalConnectionToExternal (portcls.h)
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 |
Consulte también
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal