KSPIN_DESCRIPTOR構造体 (ks.h)
KSPIN_DESCRIPTOR構造体は、ピンの種類の基本的な KSPROPSETID_Pin プロパティを記述します。
構文
typedef struct {
ULONG InterfacesCount;
const KSPIN_INTERFACE *Interfaces;
ULONG MediumsCount;
const KSPIN_MEDIUM *Mediums;
ULONG DataRangesCount;
const PKSDATARANGE *DataRanges;
KSPIN_DATAFLOW DataFlow;
KSPIN_COMMUNICATION Communication;
const GUID *Category;
const GUID *Name;
union {
LONGLONG Reserved;
struct {
ULONG ConstrainedDataRangesCount;
PKSDATARANGE *ConstrainedDataRanges;
};
};
} KSPIN_DESCRIPTOR, *PKSPIN_DESCRIPTOR;
メンバーズ
InterfacesCount
インターフェイスによって指される配列のサイズを指定します。
Interfaces
このピン型でサポートされるインターフェイスを指定する KSPIN_INTERFACE 構造体の配列。
MediumsCount
Mediumsが指す配列内の要素の数を指定します。
Mediums
このピンの種類でサポートされるメディアを指定する KSPIN_MEDIUM 構造体の配列。
DataRangesCount
DataRangesが指す配列のサイズを指定します。
DataRanges
KSDATARANGE 構造体の配列で、このピン型でサポートされるデータ範囲を指定します。
DataFlow
KSPIN_DATAFLOW_IN またはKSPIN_DATAFLOW_OUTを指定します。 KSPROPERTY_PIN_DATAFLOWを参照してください。
Communication
KSPIN_COMMUNICATION_NONE、KSPIN_COMMUNICATION_SINK、KSPIN_COMMUNICATION_SOURCE、KSPIN_COMMUNICATION_BOTH、またはKSPIN_COMMUNICATION_BRIDGEを指定します。 各値の意味については、KSPROPERTY_PIN_COMMUNICATION を参照してください。
Category
KS ピン カテゴリ GUID へのポインターを指定します。 KS ピン カテゴリ GUID は、ピンが提供する機能の一般的なカテゴリを識別します。 KS ピン カテゴリ GUID の例として、KSNODETYPE_SPEAKER、KSNODETYPE_HEADPHONES、KSNODETYPE_MICROPHONEがあります。これらはすべて、Ksmedia.hで定義されています。 「ピン留め カテゴリ プロパティの」も参照してください。
Name
レジストリに格納されているピンの種類のローカライズされた Unicode 文字列名の GUID を指定します。
Reserved
使用されません。 名前のない構造体に対して適切な配置を強制するために使用される、名前のない共用体のメンバー。
ConstrainedDataRangesCount
ConstrainedDataRanges が指す配列内のエントリの数指定します。
ConstrainedDataRanges
KSDATARANGE 構造体 配列を指します。 ドライバーの内部状態に基づいて、ピンの種類が現在サポートしているデータ範囲のセットを示します。
備考
ドライバーは、通常、サポートするピンの種類ごとに 1 つのKSPIN_DESCRIPTOR構造を定義します。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | ks.h (Ks.h を含む) |
関連項目
KSDATARANGE の