고정 속성 집합

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

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

레이블	값
속성 집합 GUID	AMPROPSETID_Pin

 

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

 

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

범주 GUID	묘사
PIN_CATEGORY_ANALOGVIDEOIN	아날로그를 사용하고 디지털화하는 캡처 필터의 입력 핀입니다.
PIN_CATEGORY_CAPTURE	캡처 핀.
PIN_CATEGORY_CC	줄 21에서 선택 자막 데이터를 제공하는 고정입니다.
PIN_CATEGORY_EDS	확장 데이터 서비스를 제공하는 핀(줄 21, 짝수 필드).
PIN_CATEGORY_NABTS	북미 Videotext Standard 데이터를 제공하는 핀입니다.
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 표면 할당자 필터입니다. 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 함수를 사용하여 인터페이스 포인터를 해제합니다.

 

관련 항목

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

속성 집합

범주 고정 작업