structure KSPIN_CONNECT (ks.h)

Les clients utilisent la structure KSPIN_CONNECT pour décrire la connexion qu’ils demandent à un pilote dans un appel KsCreatePin .

Syntaxe

typedef struct {
  KSPIN_INTERFACE Interface;
  KSPIN_MEDIUM    Medium;
  ULONG           PinId;
  HANDLE          PinToHandle;
  KSPRIORITY      Priority;
} KSPIN_CONNECT, *PKSPIN_CONNECT;

Membres

Interface

Spécifie le KSPIN_INTERFACE à utiliser pour cette connexion.

Medium

Structure de type KSPIN_MEDIUM qui spécifie le support à utiliser pour cette connexion.

PinId

Spécifie le numéro d’ID du type de broche. Si le champ PinToHandle n’a pas la valeur NULL, ce champ contient l’identificateur de la broche source à laquelle la demande est envoyée. Sinon, ce champ fait référence à la broche du récepteur à laquelle est connecté. Si une broche peut prendre en charge le fait d’être à la fois source et récepteur dans les communications, il s’agit de la méthode implicite pour lui indiquer comment elle doit agir dans la connexion.

PinToHandle

Spécifie le type d’épingle de destination auquel la création est destinée et, dans le cas d’une destination source, la broche à laquelle se connecter. Ce membre a la valeur NULL lorsqu’un client demande une connexion à lui-même. Sinon, il s’agit de la cible de la demande de connexion. Dans le cas d’une destination source, il contient le handle de la broche instance à laquelle établir une connexion. Dans le cas d’une destination de récepteur, ce champ contient NULL et n’est pas utilisé autrement.

Priority

Structure de type KSPRIORITY qui spécifie la priorité de la connexion, généralement KSPRIORITY_NORMAL. Pour plus d’informations , consultez la propriété KSPROPERTY_CONNECTION_PRIORITY.

Remarques

Si le KSPIN_CONNECT. L’élément PinToHandle n’est pas NULL, IRP_MJ_CREATE indique à l’appareil de connecter le KSPIN_CONNECT source. PinId au KSPIN_CONNECT. PinToHandle instance. Sinon, il s’agit d’une demande de connexion d’un client au KSPIN_CONNECT. PinId à l’aide du KSPIN_CONNECT. Méthode moyenne et format de données spécifique spécifié après la structure de connexion. Dans les deux cas, le pilote de périphérique peut échouer cette demande si cette connexion ne peut pas être acceptée.

Configuration requise

Voir aussi

KSPIN_INTERFACE

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin