KSHANDSHAKE 構造体 (ks.h)

KSHANDSHAKE 構造体は、プライベート インターフェイスのネゴシエートを試みるためにピンがハンドシェイクされている間に、情報をやり取りするために使用されます。

構文

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

メンバーズ

ProtocolId

このメンバーは、2 つの AVStream ピン間でネゴシエートされるインターフェイスまたはプロトコルを表す GUID を指定します。

Argument1

インターフェイスに依存する引数へのポインター。 ほとんどの場合、これは、特定のプライベート インターフェイスまたはプロトコルが合意されると、COM スタイルのインターフェイス ポインターをやり取りするために使用されます。

Argument2

インターフェイスに依存する引数へのポインター。

備考

AVStream ピン間のプライベート インターフェイスのネゴシエートの詳細については、KsPinHandshake の を参照してください。

ピン ハンドシェイクは、IOCTL_KS_HANDSHAKEをサポートする 2 つのピン間でのみ使用できる概念です。 現時点では、AVStream ピンのみがこのインターフェイスをサポートしています。したがって、これは 2 つの AVStream ピン間のプライベート インターフェイスをネゴシエートする場合にのみ役立ちます。 現在、AVStream ピン間の接続は、このメカニズムを介してネゴシエートされます。

必要条件

要件	価値
サポートされる最小クライアント	Microsoft Windows XP 以降のオペレーティング システムおよび Microsoft DirectX 8.0 以降のバージョンで使用できます。
ヘッダー	ks.h (Ks.h を含む)

関連項目

IOCTL_KS_HANDSHAKE

KsPinHandshake を する