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
| Condition requise | Valeur |
|---|---|
| En-tête | ks.h (inclure Ks.h) |