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 la 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 d’épingle. Si le champ PinToHandle n’est pas NULL, ce champ contient l’identificateur de l’épingle source à laquelle la requête est envoyée. Dans le cas contraire, ce champ fait référence à la broche de récepteur à laquelle il est connecté. Si une broche peut prendre en charge l’utilisation d’une source et d’un récepteur dans les communications, il s’agit de la méthode implicite de 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, de l’épingle à laquelle se connecter. Ce membre est NULL lorsqu’un client demande une connexion à elle-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 l’instance de broche pour é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. Épingler PinId au KSPIN_CONNECT. Instance de broche PinToHandle. Sinon, il s’agit d’une demande d’un client pour la connexion au KSPIN_CONNECT. Épingle 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.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ks.h (include Ks.h) |