핀 프로퍼티 세트

핀 프로퍼티 세트는, 필터의 핀의 핀 카테고리를 돌려준다. 카테고리는, 필터가 핀을 생성 할 경우에 그 필터에 의해 설정된다. 카테고리는, 이 핀에 출력되는 데이터형 또는 이 핀이 받는 데이터형을 나타낸다.

프로퍼티 세트 GUID

AMPROPSETID_Pin

프로퍼티 ID	설명
AMPROPERTY_PIN_CATEGORY	핀의 카테고리를 지정한다.

DirectShow 에서는, Uuids.h 헤더 파일에 다음의 핀 카테고리가 정의되고 있다.

카테고리 GUID	설명
PIN_CATEGORY_ANALOGVIDEOIN	아날로그 신호를 입력해 디지털화하는 캡춰 필터의 입력 핀.
PIN_CATEGORY_CAPTURE	캡춰 핀.
PIN_CATEGORY_CC	Line 21 으로부터의 자막 방송 데이터를 제공하는 핀.
PIN_CATEGORY_EDS	확장 데이터 서비스 (Line 21, 짝수 필드)를 제공하는 핀.
PIN_CATEGORY_NABTS	북미 비디오 텍스트 규격 데이터를 제공하는 핀.
PIN_CATEGORY_PREVIEW	프리뷰 핀.
PIN_CATEGORY_STILL	정지화면을 제공하는 핀. 정지화면 핀이 접속되기 전에, 필터의 캡춰 핀을 접속해 둘 필요가 있다.
PIN_CATEGORY_TELETEXT	문자방송 (자막 방송의 변종)을 제공하는 핀.
PIN_CATEGORY_TIMECODE	타임 코드 데이터를 제공하는 핀.
PIN_CATEGORY_VBI	수직 동기 간격 데이터를 제공하는 핀.
PIN_CATEGORY_VIDEOPORT	오버레이 믹서의 입력 핀 0 에 접속하는 비디오 출력 핀.
PIN_CATEGORY_VIDEOPORT_VBI	VBI 표면 할당자에 접속되는 핀. 이 VBI 표면 할당자 필터는, 비디오 포트가 사용되는 경우의 자막 방송 오버레이와 같은 것에 올바른 비디오 메모리를 할당할 때 필요하다. PCI, IEEE 1394, USB 시나리오는 이 필터를 사용하지 않는다. 더 자세한 정보는, 「Microsoft TV 테크놀러지」를 참조할것.
PINNAME_VIDEO_CC_CAPTURE	자막 방송 핀을 슬라이스 하는 하드웨어.

이 프로퍼티는 읽기 전용이다.

샘플 코드

다음 샘플 코드는, 핀이 이 프로퍼티 세트를 지원 하고 있을지 어떨지를 체크하는 방법과 지원 하고 있는 경우는 핀 카테고리를 얻어온다 방법을 나타내고 있다.

HRESULT GetPinCategory(IPin *pPin, GUID *pPinCategory)
{
    HRESULT hr;
    IKsPropertySet *pKs;
    hr = pPin->QueryInterface(IID_IKsPropertySet, (void **) &pKs);
    if (FAILED(hr))
    {
        // 핀은 IKsPropertySet 를 지원 하고 있지 않다.
        return hr;
    }
    // 핀 카테고리를 취득하려고 한다.
    DWORD cbReturned;
    hr = pKs->Get(AMPROPSETID_Pin, AMPROPERTY_PIN_CATEGORY, NULL, 0, 
        pPinCategory, sizeof(GUID), &cbReturned);

    // 이 호출에 성공하면 pPinCategory 에는 카테고리 GUID 가 저장 된다.

    pKs->Release();
    return hr;
}

참조

↑TOP