PcRegisterPhysicalConnectionToExternal, fonction (portcls.h)

Article
08/07/2023

La fonction PcRegisterPhysicalConnectionToExternal enregistre une connexion physique d’un filtre d’adaptateur audio à un filtre d’adaptateur audio externe.

Syntaxe

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionToExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNKNOWN        FromUnknown,
  [in] ULONG           FromPin,
  [in] PUNICODE_STRING ToString,
  [in] ULONG           ToPin
);

Paramètres

[in] DeviceObject

Pointeur vers l’objet d’appareil pour l’appareil. Il s’agit d’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] ToString

Pointeur vers une chaîne Unicode terminée par une valeur Null contenant le nom de lien symbolique du filtre externe qui fournit la broche du récepteur pour la connexion.

[in] ToPin

Spécifie un ID de broche. Ce paramètre identifie la broche du récepteur (entrée) sur le filtre externe nommé par ToString.

Valeur retournée

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

Remarques

Un pilote d’adaptateur appelle PcRegisterPhysicalConnectionToExternal 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.

Cette fonction est utile pour spécifier un lien de topologie entre deux cartes audio contrôlées par différents pilotes d’adaptateur. La fonction enregistre une connexion physique entre un objet de filtre représentant un sous-appareil dans l’adaptateur audio local et un objet de filtre représentant un sous-appareil dans une carte externe.

Le paramètre ToString est un lien symbolique vers le sous-appareil exposé par le pilote d’adaptateur externe.

Les informations requises pour inscrire une connexion physique externe doivent être fournies aux deux pilotes. Cela peut être effectué lors d’une installation coordonnée initiale des deux appareils ou dynamiquement par un programme de configuration en mode utilisateur qui coordonne les modifications apportées à la configuration des deux appareils.

Un pilote d’adaptateur peut appeler la méthode IUnregisterPhysicalConnection ::UnregisterPhysicalConnectionToExternal pour supprimer l’inscription d’une connexion physique inscrite par un appel précédent à PcRegisterPhysicalConnectionToExternal. 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 PcRegisterPhysicalConnectionToExternal 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