Funzione PcRegisterPhysicalConnection (portcls.h)

Articolo
02/29/2024

La funzione PcRegisterPhysicalConnection registra una connessione fisica tra due filtri adattatori audio creati dallo stesso driver dell'adattatore.

Sintassi

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

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo per il dispositivo adattatore. Questo parametro deve puntare a 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 sottodevice che fornisce il pin dell'origine dati della connessione (output).

[in] FromPin

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

[in] ToUnknown

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

[in] ToPin

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

Valore restituito

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

Commenti

Un driver della scheda chiama PcRegisterPhysicalConnection 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 .

I parametri forniti dal chiamante alla funzione PcRegisterPhysicalConnection descrivono una connessione fisica tra due sottodevice (rappresentati come singoli filtri) nella stessa scheda adattatore.

A differenza di una connessione logica tra due pin, che può essere configurata sotto il controllo software, una connessione fisica è hardwired. Ad esempio, una scheda adattatore tipica potrebbe avere una connessione fisica che trasporta il segnale analogico dal pin di output del filtro di output dell'onda al pin di input del relativo filtro di topologia.

Per un esempio della routine di avvio del dispositivo del driver di adattatore (vedere Sequenza di avvio) che usa la chiamata PcRegisterPhysicalConnection per registrare le connessioni fisiche di un adattatore, vedere il codice sorgente per il driver audio di esempio SB16 in Microsoft Windows Driver Kit (WDK).

Un driver della scheda può chiamare il metodo IUnregisterPhysicalConnection::UnregisterPhysicalConnection per eliminare la registrazione di una connessione fisica registrata da una chiamata precedente a PcRegisterPhysicalConnection. Per altre informazioni, vedere Sottodispositivi audio dinamici.

Requisiti

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