Funzione PcRegisterPhysicalConnectionFromExternal (portcls.h)

Articolo
08/07/2023

La funzione PcRegisterPhysicalConnectionFromExternal registra una connessione fisica a un filtro di adattatore audio da un filtro di adattatore audio esterno.

Sintassi

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

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo per il dispositivo. Si tratta di una struttura di sistema di tipo DEVICE_OBJECT.

[in] FromString

Puntatore a una stringa Unicode con terminazione Null contenente il nome del collegamento simbolico del filtro esterno che fornisce il pin di origine della connessione.

[in] FromPin

Specifica un ID pin. Questo parametro identifica il pin di origine (output) sul filtro esterno denominato da FromString.

[in] ToUnknown

Puntatore all'interfaccia IPort di un oggetto driver di porta. L'oggetto driver di porta associato a ToUnknown è associato al sottodispositivo che fornisce il pin (input) del sink di dati della connessione.

[in] ToPin

Specifica un ID pin. Questo parametro identifica il pin sink (input) sul filtro associato all'interfaccia ToUnknown .

Valore restituito

PcRegisterPhysicalConnectionFromExternal restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.

Commenti

Un driver dell'adattatore chiama PcRegisterPhysicalConnectionFromExternal per registrare una connessione fisica con il driver di sistema PortCls. PortCls archivia queste informazioni in modo che il driver della porta possa successivamente usare le informazioni per rispondere alle richieste di proprietà KSPROPERTY_PIN_PHYSICALCONNECTION .

Questa funzione è utile per specificare un collegamento di topologia tra due adattatori audio controllati da driver di adattatori diversi. La funzione registra una connessione fisica tra un oggetto filtro che rappresenta un sottodispositivo nella scheda audio locale e un oggetto filtro che rappresenta un sottodispositivo in una scheda esterna.

Il parametro FromString è un collegamento simbolico al sottodispositivo esposto dal driver dell'adattatore esterno.

Le informazioni necessarie per registrare una connessione fisica esterna devono essere fornite ai due driver. Questa operazione può essere eseguita durante un'installazione coordinata iniziale dei due dispositivi oppure può essere eseguita dinamicamente da un programma di configurazione in modalità utente che coordina le modifiche alle configurazioni di entrambi i dispositivi.

Un driver dell'adattatore può chiamare il metodo IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal per eliminare la registrazione di una connessione fisica registrata da una chiamata precedente a PcRegisterPhysicalConnectionFromExternal. Per altre informazioni, vedere Dispositivi secondari audio dinamici.

Requisiti

Requisito	Valore
Client minimo supportato	Il driver di sistema PortCls implementa la funzione PcRegisterPhysicalConnectionFromExternal in Microsoft Windows 98/Me e nei sistemi operativi Windows 2000 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	portcls.h (include Portcls.h)
Libreria	Portcls.lib
IRQL	PASSIVE_LEVEL