Structure KSHANDSHAKE (ks.h)

La structure KSHANDSHAKE est utilisée pour transmettre des informations d’un point à l’autre pendant que les broches sont en cours d’établissement dans le cadre d’une tentative de négociation d’une interface privée.

Syntaxe

typedef struct {
  GUID  ProtocolId;
  PVOID Argument1;
  PVOID Argument2;
} KSHANDSHAKE, *PKSHANDSHAKE;

Membres

ProtocolId

Ce membre spécifie le GUID qui représente l’interface ou le protocole en cours de négociation entre deux broches AVStream.

Argument1

Pointeur vers un argument dépendant de l’interface. Le plus souvent, cela est utilisé pour passer des pointeurs d’interface de style COM une fois qu’une interface ou un protocole privé spécifique a été convenu.

Argument2

Pointeur vers un argument dépendant de l’interface.

Remarques

Pour plus d’informations sur la négociation d’interfaces privées entre des broches AVStream, consultez KsPinHandshake .

La négociation de broches est un concept utilisable uniquement entre deux broches qui prennent en charge IOCTL_KS_HANDSHAKE. Actuellement, seules les broches AVStream prennent en charge cette interface ; par conséquent, cela n’est utile que pour la négociation d’interfaces privées entre deux broches AVStream. Actuellement, les connexions entre les broches AVStream sont négociées via ce mécanisme.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et dans Microsoft DirectX 8.0 et versions ultérieures.
En-tête	ks.h (inclure Ks.h)

Voir aussi

IOCTL_KS_HANDSHAKE

KsPinHandshake