PcRegisterPhysicalConnectionFromExternal, fonction (portcls.h)

Article
02/26/2024

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

Syntaxe

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionFromExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNICODE_STRING FromString,
  [in] ULONG           FromPin,
  [in] PUNKNOWN        ToUnknown,
  [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] FromString

Pointeur vers une chaîne Unicode terminée par null contenant le nom de lien symbolique du filtre externe qui fournit le code pin source de la connexion.

[in] FromPin

Spécifie un ID de broche. Ce paramètre identifie la broche source (sortie) sur le filtre externe nommé par FromString.

[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

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

Remarques

Un pilote d’adaptateur appelle PcRegisterPhysicalConnectionFromExternal 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 FromString 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 cela peut être effectué dynamiquement par un programme de configuration en mode utilisateur qui coordonne les modifications apportées aux configurations des deux appareils.

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