KSPIN_DESCRIPTOR 構造体 (ks.h)

[アーティクル]
02/29/2024

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 が指す配列のサイズを指定 します。

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 の例として、 Ksmedia.h で定義されているKSNODETYPE_SPEAKER、KSNODETYPE_HEADPHONES、KSNODETYPE_MICROPHONEがあります。「 Pin Category プロパティ」も参照してください。

Name

レジストリに格納されているピンの種類のローカライズされた Unicode 文字列名の GUID を指定します。

Reserved

使用されていません。名前のない構造体に対して適切なアラインメントを強制するために使用される、名前のない共用体のメンバー。

ConstrainedDataRangesCount

ConstrainedDataRanges が指す配列内のエントリの数を指定します。

ConstrainedDataRanges

KSDATARANGE 構造体の配列を指します。ドライバーの内部状態に基づいて、ピンの種類が現在サポートしているデータ範囲のセットを示します。