IKsPin ::KsGetCurrentCommunication, méthode (ksproxy.h)
La méthode KsGetCurrentCommunication récupère la direction de communication actuelle, 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 du type énuméré KSPIN_COMMUNICATION décrivant la direction de communication actuelle 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 réceptrices IRP. Ces broches ne peuvent être connectées qu’aux 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’aux broches du 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 les instances peuvent être créées dessus pour recevoir des demandes d’E/S non 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 de retour
Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.
Remarques
Les broches sources envoient des IRPs aux broches récepteurs. Ne confondez pas le sens de la 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 de récepteur peut avoir des données lues ou écrites à partir de celle-ci.
La direction de communication actuelle, l’interface et le support d’une broche sont un sous-ensemble de ceux disponibles pour la broche et sont sélectionnés lorsque le handle d’épingle est créé.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | ksproxy.h (include Ksproxy.h) |