Méthode IKsPin ::KsGetCurrentCommunication (ksproxy.h)

Article
02/29/2024

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.