Funzione PcRegisterPhysicalConnectionToExternal (portcls.h)

Articolo
02/29/2024

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

Sintassi

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

Puntatore all'interfaccia IPort di un oggetto driver di porta. L'oggetto driver di porta associato a FromUnknown è associato al sottodispositivo che fornisce l'origine dati (output) della connessione.

[in] FromPin

Specifica un ID pin. Questo parametro identifica il pin di origine (output) sul filtro associato all'interfaccia FromUnknown .

[in] ToString

Puntatore a una stringa Unicode con terminazione Null contenente il nome del collegamento simbolico del filtro esterno che fornisce il pin sink per la connessione.

[in] ToPin

Specifica un ID pin. Questo parametro identifica il pin sink (input) nel filtro esterno denominato da ToString.

Valore restituito

PcRegisterPhysicalConnectionToExternal 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 PcRegisterPhysicalConnectionToExternal 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 ToString è 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 o dinamicamente da un programma di configurazione in modalità utente che coordina le modifiche alla configurazione di entrambi i dispositivi.

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

Requisiti

Requisito	Valore
Client minimo supportato	Il driver di sistema PortCls implementa la funzione PcRegisterPhysicalConnectionToExternal 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