KSPIN_DESCRIPTOR結構 (ks.h)

發行項
02/26/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

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 中。另請參閱 Pin 類別屬性。

Name

指定固定類型之當地語系化 Unicode 字串名稱的 GUID，儲存在登錄中。

Reserved

未使用。未命名等位的成員，用來強制在未命名結構上正確對齊。

ConstrainedDataRangesCount

指定 由 ConstrainedDataRanges 指向之陣列中的項目數。

ConstrainedDataRanges

指向 KSDATARANGE 結構的數位。根據驅動程式的內部狀態，指出目前針腳類型所支持的數據範圍集合。