다음을 통해 공유


AMOVIESETUP_FILTER 구조체

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

AMOVIESETUP_FILTER 구조에는 필터를 등록하기 위한 정보가 포함되어 있습니다.

구문

typedef struct _AMOVIESETUP_FILTER {
  const  CLSID           *clsID;
  const  WCHAR           *strName;
  DWORD                  dwMerit;
  UINT                   nPins;
  const  AMOVIESETUP_PIN *lpPin;
} AMOVIESETUP_FILTER, *PAMOVIESETUP_FILTER, *FAR LPAMOVIESETUP_FILTER;

멤버

Clsid

필터의 클래스 식별자입니다.

strName

필터의 이름입니다.

dwMerit

필터 장점. 필터 그래프를 생성할 때 IGraphBuilder 인터페이스에서 사용됩니다. 장점 값 목록은 장점을 참조 하세요.

nPins

lpPin 배열의 요소 수입니다. lpPinNULL인 경우 이 멤버를 0으로 설정합니다.

lpPin

nPin 크기의 AMOVIESETUP_PIN 구조체 배열에 대한 포인터입니다. 이 배열의 각 멤버는 필터의 핀을 설명합니다.

설명

이 구조를 사용하는 방법에 대한 자세한 내용은 DirectShow 필터를 등록하는 방법을 참조하세요. 기본 필터 범주(CLSID_LegacyAmFilterCategory)에 등록된 필터에만 이 구조를 사용합니다. 다른 범주에 필터를 등록하려면 DllRegisterServer 구현에 설명된 대로 IFilterMapper2::RegisterFilter 메서드를 사용합니다.

참고

헤더 파일 combase.h는 DirectShow 기본 클래스와 함께 제공됩니다.

요구 사항

요구 사항
헤더
Combase.h(Streams.h 포함)

추가 정보

DirectShow 구조체