PcRegisterPhysicalConnection, fonction (portcls.h)

Article
08/07/2023

La fonction PcRegisterPhysicalConnection enregistre une connexion physique entre deux filtres d’adaptateur audio instanciés par le même pilote d’adaptateur.

Syntaxe

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

Paramètres

[in] DeviceObject

Pointeur vers l’objet d’appareil pour l’appareil adaptateur. Ce paramètre doit pointer vers une structure système de type DEVICE_OBJECT.

[in] FromUnknown

Pointeur vers l’interface IPort d’un objet de pilote de port. L’objet pilote de port associé à FromUnknown est lié au sous-appareil qui fournit le code pin de la source de données (sortie) de la connexion.

[in] FromPin

Spécifie un ID de broche. Ce paramètre identifie la broche source (sortie) sur le filtre associé à l’interface FromUnknown .

[in] ToUnknown

Pointeur vers l’interface IPort d’un objet de pilote de port. L’objet pilote de port associé à ToUnknown est lié au sous-appareil qui fournit la broche du récepteur de données (entrée) de la connexion.

[in] ToPin

Spécifie un ID de broche. Ce paramètre identifie la broche du récepteur (entrée) sur le filtre associé à l’interface ToUnknown .

Valeur retournée

PcRegisterPhysicalConnection retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié.

Remarques

Un pilote d’adaptateur appelle PcRegisterPhysicalConnection pour inscrire une connexion physique avec le pilote système PortCls. PortCls stocke ces informations afin que le pilote de port puisse ensuite utiliser les informations pour répondre à KSPROPERTY_PIN_PHYSICALCONNECTION demandes de propriétés.

Les paramètres que l’appelant fournit à la fonction PcRegisterPhysicalConnection décrivent une connexion physique entre deux sous-appareils (représentés sous la forme de filtres individuels) sur la même carte carte.

Contrairement à une connexion logique entre deux broches, qui peut être configurée sous contrôle logiciel, une connexion physique est câblée. Par exemple, un adaptateur classique carte peut avoir une connexion physique qui transporte le signal analogique de la broche de sortie de son filtre de sortie d’onde à la broche d’entrée de son filtre de topologie.

Pour obtenir un exemple de routine de démarrage d’appareil d’un pilote d’adaptateur (voir Séquence de démarrage) qui utilise l’appel PcRegisterPhysicalConnection pour inscrire les connexions physiques d’un adaptateur, consultez le code source de l’exemple de pilote audio SB16 dans le Kit de pilotes Microsoft Windows (WDK).

Un pilote d’adaptateur peut appeler la méthode IUnregisterPhysicalConnection ::UnregisterPhysicalConnection pour supprimer l’inscription d’une connexion physique inscrite par un appel précédent à PcRegisterPhysicalConnection. Pour plus d’informations, consultez Sous-appareils audio dynamiques.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Le pilote système PortCls implémente la fonction PcRegisterPhysicalConnection dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et ultérieurs.
Plateforme cible	Universal
En-tête	portcls.h (include Portcls.h)
Bibliothèque	Portcls.lib
IRQL	PASSIVE_LEVEL