Share via


속성 집합(DirectShow)

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

Microsoft DirectShow는 속성 집합을 사용하여 하드웨어 및 관련 드라이버 및 필터에서 제공하는 확장 서비스를 지원합니다. 하드웨어 및 필터 공급업체는 새 기능을 속성으로 정의하고, 속성 집합에 정렬하고, 이러한 속성 집합에 대한 사양을 게시할 수 있습니다. 애플리케이션 개발자는 IKsPropertySet 인터페이스의 메서드를 사용하여 드라이버 또는 필터가 특정 속성 집합을 지원하는지 확인하고 해당 속성을 검색하거나 설정할 수 있습니다.

IKsPropertySet에 의해 노출되는 모든 메서드에는 속성 집합(guidPropSet 매개 변수)을 식별하는 GUID와 속성 집합 내의 속성을 식별하는 DWORD(dwPropID 매개 변수)가 필요합니다. dwPropID 매개 변수는 일반적으로 열거된 데이터 형식의 멤버입니다.

개별 속성에는 IKsPropertySet::Set 및 IKsPropertySet::Get 메서드의 pPropData 매개 변수에 지정한 관련 데이터가 있을 수 있습니다. 이러한 메서드에서 속성 데이터는 에 대한 포인터 void로 입력됩니다. 데이터 형식 및 데이터의 의미는 속성 집합의 정의에 지정됩니다.

다음 섹션에서는 DirectShow에서 지원되는 속성 집합에 대한 정보를 제공합니다.