다음을 통해 공유


Pin 속성 집합

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

pin 속성 집합은 필터의 핀에 대한 핀 범주를 반환합니다. 범주는 핀을 만들 때 필터에 의해 설정됩니다. 범주는 핀이 이 핀에 의해 전달되거나 수신되는 데이터 형식을 나타냅니다.

레이블
속성 집합 GUID AMPROPSETID_Pin

 

속성 ID Description
AMPROPERTY_PIN_CATEGORY 핀의 범주를 지정합니다.

 

DirectShow는 Uuids.h 헤더 파일에서 다음 핀 범주를 정의합니다.

범주 GUID Description
PIN_CATEGORY_ANALOGVIDEOIN 아날로그를 사용하고 디지털화하는 캡처 필터의 입력 핀입니다.
PIN_CATEGORY_CAPTURE 캡처 핀.
PIN_CATEGORY_CC 줄 21에서 선택 자막 데이터를 제공하는 핀입니다.
PIN_CATEGORY_EDS 확장 데이터 서비스를 제공하는 핀(줄 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 Surface 할당자 필터인 VBI Surface 할당자에 연결되도록 고정합니다. PCI, IEEE 1394 및 USB 시나리오에서는 이 필터를 사용하지 않습니다.
PINNAME_VIDEO_CC_CAPTURE 하드웨어 조각화 선택 자막 핀

 

이 속성은 읽기 전용입니다.

코드 예

다음 코드는 핀이 이 속성 집합을 지원하는지 여부를 검사 핀 범주를 가져오는 방법을 보여 줍니다.

HRESULT GetPinCategory(IPin *pPin, GUID *pPinCategory)
{
    IKsPropertySet *pKs = NULL;

    HRESULT hr = pPin->QueryInterface(IID_PPV_ARGS(&pKs));
    if (FAILED(hr))
    {
        return hr;
    }

    // Try to retrieve the pin category.
    DWORD cbReturned = 0;
    hr = pKs->Get(AMPROPSETID_Pin, AMPROPERTY_PIN_CATEGORY, NULL, 0, 
        pPinCategory, sizeof(GUID), &cbReturned);
    
    // If this succeeded, pPinCategory now contains the category GUID.

    SafeRelease(&pKs);
    return hr;
}

참고

이 예제에서는 SafeRelease 함수를 사용하여 인터페이스 포인터를 해제합니다.

 

캡처 필터에 대한 고정 요구 사항

속성 집합

고정 범주 작업