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의 예로는 모두 Ksmedia.h에 정의된 KSNODETYPE_SPEAKER, KSNODETYPE_HEADPHONES 및 KSNODETYPE_MICROPHONE 있습니다. 범주 속성 고정도 참조하세요.

Name

레지스트리에 저장된 핀 형식에 대한 지역화된 유니코드 문자열 이름의 GUID를 지정합니다.

Reserved

사용되지 않습니다. 명명되지 않은 구조체에 적절한 맞춤을 강제 적용하는 데 사용되는 명명되지 않은 공용 구조체의 멤버입니다.

ConstrainedDataRangesCount

ConstrainedDataRanges가 가리키는 배열의 항목 수를 지정합니다.

ConstrainedDataRanges

KSDATARANGE 구조체의 배열을 가리킵니다. 드라이버의 내부 상태에 따라 핀 유형이 현재 지원하는 데이터 범위 집합을 나타냅니다.