Méthode IKsPin ::KsGetCurrentCommunication (ksproxy.h)
La méthode KsGetCurrentCommunication récupère le sens de communication actuel, l’interface et le support d’une broche.
Syntaxe
HRESULT KsGetCurrentCommunication(
[out, optional] KSPIN_COMMUNICATION *Communication,
[out, optional] KSPIN_INTERFACE *Interface,
[out, optional] KSPIN_MEDIUM *Medium
);
Paramètres
[out, optional] Communication
Pointeur vers une variable qui reçoit l’une des valeurs suivantes de l’KSPIN_COMMUNICATION type énuméré décrivant le sens de communication actuel d’une broche :
| Valeur | Description |
|---|---|
| KSPIN_COMMUNICATION_NONE | La fabrique de broches ne crée aucune instance de broche. |
| KSPIN_COMMUNICATION_SINK | La fabrique de broches crée des instances de broches de récepteur IRP. Ces broches ne peuvent être connectées qu’à des broches sources IRP. |
| KSPIN_COMMUNICATION_SOURCE | La fabrique de broches crée des instances de broches sources IRP. Ces broches ne peuvent être connectées qu’à des broches de récepteur IRP. |
| KSPIN_COMMUNICATION_BOTH | La fabrique de broches crée des instances de broches qui sont à la fois des récepteurs IRP et des sources IRP. |
| KSPIN_COMMUNICATION_BRIDGE | La broche ne peut pas se connecter à d’autres broches, mais des instances peuvent être créées dessus pour recevoir des demandes d’E/S autres que KS. |
[out, optional] Interface
Pointeur vers une variable qui reçoit une structure KSPIN_INTERFACE qui décrit l’interface actuelle d’une broche.
[out, optional] Medium
Pointeur vers une variable qui reçoit une structure KSPIN_MEDIUM qui décrit le support actuel d’une broche.
Valeur retournée
Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.
Remarques
Les broches sources envoient des IRP aux broches du récepteur. Ne confondez pas le sens de communication avec le sens du flux de données. (Voir KSPROPERTY_PIN_DATAFLOW.) Une broche source peut lire ou écrire des données, et une broche récepteur peut avoir des données lues ou écrites à partir de celle-ci.
Le sens de communication actuel, l’interface et le support d’une broche sont un sous-ensemble de ceux disponibles pour la broche et sont sélectionnés lors de la création de la poignée de broche.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ksproxy.h (inclure Ksproxy.h) |